zowe › ca7 › commands › jclovrd🖨️

The JCLOVRD command establishes or satisfies JCL override requirements.
This command is primarily used when the CPU job does not have a permanent JCL override requirement assigned.
The CPU job for which the JCL override is being established (or satisfied) must be in the request queue.
If you are using CA Workload Automation CA 7 Edition to insert IBM WLM scheduling environment keywords on JOB statements,
you can use the JCLOVRD command to suppress or allow SCHENV= keyword insertion.
This function is available as the J value for FILL FUNCTION on the QM.1 panel.
The function can also be accomplished with the QM.2 and QM.3 panels.

Usage

zowe ca7 commands jclovrd [options]

Required Options

• --ca7Id (string)

  • CA7ONL Instance

• --ca7Id (string)

  • CA7ONL Instance

Options

• --key (string)

  • The command transaction key

• --ca7# (string)

  • Defines the CA 7 job number of the job in the request queue for which to establish or remove the override requirement.
    Limits:
    1 to 4 numeric characters

• --set (string)

  • Specifies to establish or satisfy JCL override requirements.
    When a job fails with a JCL error, the JCL override requirement is automatically set to ON when the job returns to the request queue.
    The JCL override must be set to OFF before the job can be submitted again.
    ON
    Establishes a JCL override requirement for the specified job.
    The SET=ON option is used for jobs in the request queue to indicate that an override is needed before execution is to occur.
    OFF
    Satisfies a JCL override requirement for the specified job. The SET=OFF option indicates that a previously defined need (requirement) for overrides has been satisfied and execution can be safely attempted.
    When a JCL override requirement is set to OFF,
    that requirement no longer appears on a requirements list for the job
    When a REPL is done from the QM.5 panel, the JCL override requirement is automatically set to OFF.
    WLM
    Sets job to allow the insertion of SCHENV= keyword on the JOB statement at submission time when these conditions are true:
    The scheduling environment insertion feature is activated.
    A scheduling Environment VRM definition is attached to the job (or SCHENV global default).
    NOWLM
    Sets job to suppress the insertion of a SCHENV= keyword on the JOB statement at submission time even when one is typically associated with the job.
    This option can be used when the validation of an associated IBM WLM scheduling environment has failed causing the job to be requeued (see Browse message SSM0-42).
    FSetting the NOWLM option lets you submit the job without SCHENV= keyword insertion.

CA7 Connection Options

• --host | -H (string)

  • Host name of the CA7 API service that is running on the mainframe system.

• --port | -P (number)

  • Port for the CA7 API service that is running on the mainframe system.

• --user | -u (string)

  • User name for authenticating connections to the CA7 API service that is running on the mainframe system.

• --password | --pass | --pw (string)

  • Password for authenticating connections to the CA7 API service that is running on the mainframe system.

• --base-path | --bp (string)

  • The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

• --protocol | -o (string)

  • Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

Profile Options

• --ca7-profile | --ca7-p (string)

  • The name of a (ca7) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --reject-unauthorized | --ru (boolean)

  • Reject self-signed certificates.

    Default value: true

• --token-type | --tt (string)

  • The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

• --token-value | --tv (string)

  • The value of the token to pass to the API.

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication.

    Note: The CLI does not support certificate files that require a password. For more information, search Troubleshooting PEM Certificates in Zowe Docs.

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

Examples

• Establishes or satisfies JCL override requirements for CA7 number 29 on Instance1:

  • zowe ca7 commands jclovrd --ca7Id Instance1 --ca7# 29 Copy