zowe › ca7 › commands › prscf🖨️

The PRSCF command frees a shared, exclusive, or RCT resource that is connected to a job that:

Is executing
Is in ABEND status in the request queue
Has already executed and purged from the request queue
PRSCF can also remove a virtual resource from consideration of a job currently in the active workload and waiting to execute.

Usage

zowe ca7 commands prscf [options]

Required Options

• --ca7Id (string)

  • CA7ONL Instance

Options

• --key (string)

  • The command transaction key

• --job (string)

  • Specifies the CA Workload Automation CA 7 Edition job name or number to which the resource is attached.
    jobnumber
    Indicates a specific CA 7 job number.
    Limits:
    1 to 4 numeric characters

• --rsrc (string)

  • Specifies the fully qualified resource name to free.
    You can optionally specify * to indicate to free all resources that are connected to the job.
    Limits:
    1 to 44 alphanumeric characters

• --force (string)

  • (Optional) FORCE=YES indicates that CA WA CA 7 Edition is not to evaluate
    the availability of the named resources for this run of the job only.
    This run of the job does not use the named resources.
    This keyword can be used on an exception basis to let a job in a W-RSRC status bypass VRM checking for one or more resources defined for it on the RM.1 panel.

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

• Frees resources for Job PAYROLL on Instance1:

  • zowe ca7 commands prscf --ca7Id Instance1 --job PAYROLL Copy