zowe › ca7 › commands › requeue🖨️

The REQUEUE top line command moves jobs from the ready or active queues back to the request queue.
This command allows the use of the CA Workload Automation CA 7 Edition job restart facilities
after certain JCL, CPU, or node/agent failures, or job cancellation out of a CPU through the OS console.
This function is available as the Q option in the QM.1 CPU Jobs Status Prompt panel.

Usage

zowe ca7 commands requeue [options]

Required Options

• --ca7Id (string)

  • CA7ONL Instance

Options

• --key (string)

  • The command transaction key

• --agent (string)

  • (Optional) Indicates the agent name or mask that an agent name must match for an agent job
    before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    AGENT cannot be used with CPU, MAINID, or NODE.
    For any agent job that is requeued, a cancel request is sent to the agent running the job.
    The status of the agent or the computer on which the agent is running determines whether the request is honored.
    Limits:
    1 to 16 alphanumeric charactersDefault:
    * (all agent names)

• --cpu (string)

  • (Optional) Used with JOB to specify the CPU ID of active queue jobs that are to be requeued.
    The value identifies the CPU and corresponds to the CPU field displayed on the LQ command (the SMF identifier).
    CPU cannot be used with MAINID, NODE, or AGENT.
    The CPU parameter is ignored if used with a JOB parameter that references a specific job name or job number, but not if a job mask is specified.
    Limits:
    1 to 4 numeric characters

• --force (string)

  • (Optional) Resumes job completion for stranded jobs.
    When a job finishes executing, it must move to the request queue so that CA WA CA 7 Edition
    can process the database and queue updates that are required for job completion.
    But, if a job cannot be moved because of an I/O error or an out-of-space condition on the request queue,
    the job may be stranded in the ready or active queue, unable to complete
    Once the request queue error is corrected, you can use REQUEUE with FORCE=CMP to resume job completion for these jobs.
    Limits:
    CMP is the only value

• --ca7# (string)

  • (Optional) Indicates the job number
    must match before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOB is used alone, both the active and ready queues are searched for the specified job number.
    If JOB is used with Q, the search is restricted to the indicated queue. jobname,jobnumber and longjobname are mutually exclusive
    Default:
    * (all jobs)Limits:
    1 to 8 alphanumeric characters

• --jobname | --jn (string)

  • (Optional) Indicates the job name, or mask that a job name
    must match before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOB is used alone, both the active and ready queues are searched for the specified job.
    If JOB is used with Q, the search is restricted to the indicated queue. jobname,jobnumber and longjobname are mutually exclusive.
    Default:
    * (all jobs)Limits:
    1 to 8 alphanumeric characters

• --longjobname | --lon (string)

  • (Optional) Indicates the long job name or mask that a long job name must match before
    it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOBL is used alone, both the active and ready queues are searched for the specified long job name.
    If JOBL is used with Q, the search is restricted to the indicated queue.jobname,jobnumber and longjobname are mutually exclusive
    Limits:
    1 to 64 alphanumeric characters

• --mainid (string)

  • (Optional) Used with JOB to indicate that only those jobs in the ready queue with this MAINID are to be requeued.
    Value must be specified as a single MAINID name.
    MAINID cannot be used with CPU, NODE, or AGENT.
    The MAINID parameter is ignored if used with a JOB parameter that references a specific job name or job number, but not if a job mask is specifie..
    The name must be one of the following values: ALL Indicates that all MAINIDs are considered. SYn Where n indicates a CPU assigned number as defined in the initialization file CPU statement.
    The value of n can range from 1 to 7. /SYn
    Where n indicates a CPU assigned number. The / indicates "not this MAINID."
    The value of n can range from 1 to 7.Limits:
    1 to 4 alphanumeric characters

• --node (string)

  • (Optional) Indicates the node name or mask that a node name must match for an XPJOB job,
    before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    NODE cannot be used with CPU, MAINID, or AGENT.
    For any XPJOB that is requeued, a cancel request is sent to the node where the job is running
    (assuming the initialization file XPDEF statement parameter XPKILL=NO is not set).
    The status of the node or the computer that the node points to, determines whether the request is honored.
    Limits:
    1 to 8 alphanumeric characters

• -q (string)

  • (Optional) Used with JOB to indicate in which queue the job search is to occur. Possible values: ACT
    The active queue.RDY
    The ready queue

• --type (string)

  • (Optional) Flags the job after it returns to the request queue with a status of JCLERR instead of REQUE.
    If not coded, the status reflects REQUE.

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

• Requeue the top line command on Instance1:

  • zowe ca7 commands requeue --ca7Id Instance1 Copy