zowe › ca7 › job-instance › list-custom🖨️

Displays information about jobs in the active workload.

Usage

zowe ca7 job-instance list-custom [options]

Required Options

• --ca7Id (string)

  • CA7ONL Instance

Options

• --ca7no (string)

  • The CA 7 job number

• --jobname | --jn (string)

  • The CA 7 job name

• --databasename | --db (string)

  • The CA 7 database name

• --job (boolean)

  • The job name for this job in the active workload, 8 CHAR

• --queueName (boolean)

  • The name of the queue in which this job is currently located. Values are: 1=pre-processing; 2=request;3=ready; 4=active; 5=post-processing; 6=prior-run, CHAR 16

• --ca7# (boolean)

  • The job number for this job in the active workload

• --status (boolean)

  • The job status
    For more information about possible values refer to the LQ command.
    Note:
    This service determines values of status in much the same way as values are determined
    for the JOB STATUS column of the LQ command.
    The �LATE� value is an exception.
    Unlike the LQ command, this service will only evaluate and report late conditions when
    none of the other conditions are detected.
    For example, the LQ command output may report a status value of �LATE�
    even if the job is actually waiting for virtual resources.
    In such a case, this service will report �W-RSRC�.

• --entryMode (boolean)

  • Identifies how the job was brought into the queue.
    The possible values are the following:
    ARFJ
    Indicates an ARF recovery job.
    AUTO
    Indicates a triggered job.
    DEMD
    Indicates a demanded job.
    EXTL
    Indicates a job that is submitted external to CA WA CA 7 Edition
    LOAD
    Indicates a job to be loaded (brought in by the LOAD command).
    PS
    Indicates a job that the Personal Scheduling System submitted.
    RPET
    Indicates a repeated job.
    RUN
    Indicates a job that is brought in by the RUN command.
    SSCN
    Indicates a job that is brought in by schedule scan.
    XDEM
    Indicates a job brought in by the DEMAND command from an XPS client.
    XPS
    Indicates a job brought in from an XPS client using the RUN command with the REF option.
    XRUN
    Indicates a job brought in from an XPS client using the RUN command.

• --abended (boolean)

  • Y if job abended, N if not, 1 CHAR

• --agentIntervention | --age (boolean)

  • Y if INTERVENTION REQUIRED condition exists for this agent job, N if not, 1 CHAR

• --agentJobNumber | --age (boolean)

  • The job number/PID for this agent job, 28 CHAR

• --agentName (boolean)

  • The name of the agent where this job will execute, 16 CHAR

• --agentStatus | --age (boolean)

  • The status for this agent job, 40 CHAR

• --agentStatusData | --age (boolean)

  • Y if status data is available for this agent job,N if not, 1 CHAR

• --agentSubmitted | --age (boolean)

  • Y if agent job has been submitted to the agent, N if not, 1 CHAR

• --agentType (boolean)

  • Agent job type, zero if this is not an agent job, INTEGER

• --agentUser (boolean)

  • The userid with which this agent job will execute, 120 CHAR

• --ajbBuildError | --ajb (boolean)

  • Y if an error occurred while building an XPJOB job AJB or an agent job AFM, N if not, 1 CHAR

• --arf (boolean)

  • Y if this job is monitored by ARF, N if not

• --arfAttachErr | --arf (boolean)

  • Y if this job had an ARF attach error, N if not, 1 CHAR

• --arfCompMatched | --arf (boolean)

  • Set to Y if an ARF JOB completion rule matched for this job, 1 CHAR

• --arfDate (boolean)

  • Y if the job uses ARF. CA recommends using column ARF instead of this column, 1 CHAR

• --arfErrorCond | --arf (boolean)

  • Set to Y if there was an error during ARF condition detection, N if not, 1 CHAR

• --arfjJob (boolean)

  • Y if job is an ARF recovery job, N if not, 1 CHAR

• --arfJobComplete | --arf (boolean)

  • Set to Y if this job's completion has been posted to ARF, N if not, 1 CHAR

• --arfRecovery | --arf (boolean)

  • Y if job is in ARF recovery, N if not, 1 CHAR

• --arfRecoveryErr | --arf (boolean)

  • Y if this job had an error in ARF recovery, N if not, 1 CHAR

• --arfset (boolean)

  • The collection of ARF definitions that apply to this job, 8 CHAR

• --arfTime (boolean)

  • The date and time that the ARFSET was attached to this job, DATE/TIME

• --autofDone (boolean)

  • Y if job performed AUTO F, N if not, 1 CHAR

• --ca11JesNode | --ca1 (boolean)

  • The JES node where this job executes, 8 CHAR

• --ca11RestartStep | --ca1 (boolean)

  • The relative CA 11 restart step number, INTEGER

• --ca11RmsCc (boolean)

  • The CA 11 U11RMS step condition code, INTEGER

• --ca11Subsystem | --ca1 (boolean)

  • The CA 11 subsystem name

• --ca7System (boolean)

  • The user-defined application system associated with this job, 8 CHAR

• --compCode (boolean)

  • The job completion code in number format, INTEGER

• --cpmJfm (boolean)

  • Y if JFM is used to track CPM, N if not, 1 CHAR

• --cpuTableIndex | --cpu (boolean)

  • Index to the CPU Table entry, SMALLINT

• --cputime (boolean)

  • This Job's average CPU time, PACKED

• --currStepNum | --cur (boolean)

  • The number of the step that is currently executing, INTEGER

• --defNotFound | --def (boolean)

  • Y if job defintion not found on database, N if not found, 1 CHAR

• --doNotPrompt | --doN (boolean)

  • Y if prompts are bypassed for the job, N if not, 1 CHAR

• --drclass (boolean)

  • The job's disaster recovery class, 8 CHAR

• --drmode (boolean)

  • Y if this job entered the queues when disaster recovery mode was active, N if not, 1 CHAR

• --dueOutExists | --due (boolean)

  • Determines if a zero value in DUE_OUT_TIME indicates midnight (Y) or no due out time (N), 1 CHAR

• --dueOutTime | --due (boolean)

  • The date and time this job is expected to complete, DATE/TIME

• --dupJob (boolean)

  • Y if a job with the same name is waiting on this job to complete, N if not, 1 CHAR

• --dupJobWait | --dup (boolean)

  • Y if this job is waiting on a job with the same name to complete, N if not, 1 CHAR

• --elapsedTime | --ela (boolean)

  • This Job's average elapsed time, PACKED

• --endTime (boolean)

  • The date and time this job ended, DATE/TIME

• --executable | --exe (boolean)

  • Y if job is executable, N if not, 1 CHAR

• --express (boolean)

  • Y if submission of this job has been expedited by use of the SUBMIT,EXPRESS=YES command, N if not, 1 CHAR

• --externalInput | --ext (boolean)

  • Y if we job has external input, N if not, 1 CHAR

• --externalJob | --ext (boolean)

  • Y if this is an externally tracked job, N if not, 1 CHAR

• --externalSatisfied | --ext (boolean)

  • The number of satisfied external requirements for this job, INTEGER

• --externalTotal | --ext (boolean)

  • The total number of external requirements for this job, INTEGER

• --forcedComplete | --for (boolean)

  • Y if job was force completed, N if not, 1 CHAR

• --forcedSubmit | --for (boolean)

  • Y if all input requirements have been marked as satisfied by use of the SUBMIT command, N if not, 1 CHAR

• --fromXpRequest | --fro (boolean)

  • Y if scheduling request for this job came from an XPS client, N if not, 1 CHAR

• --hasCa11 (boolean)

  • Y if job has a CA11 segment, N if not, 1 CHAR

• --hasCpuTime | --has (boolean)

  • Y if we have non-zero CPU time for this job, N if not, 1 CHAR

• --hasJo (boolean)

  • Y if the JCL or PARM DATA contains a #JO card, N if not, 1 CHAR

• --hasStepTime | --has (boolean)

  • Y if job has non-zero step CPU time, N if not, 1 CHAR

• --held (boolean)

  • Y if job is held, N if not, 1 CHAR

• --heldByJob (boolean)

  • Y if job was held on entry to the queues, N if not, 1 CHAR

• --heldSkeleton | --hel (boolean)

  • Y if job is held and in skeleton status, N if not, 1 CHAR

• --skeleton (boolean)

  • Y if job is in skeleton status, N if not, 1 CHAR

• --holdOnEntry | --hol (boolean)

  • Y if job marked HOLD=YES, N if not, 1 CHAR

• --hostName (boolean)

  • The SMF Id of the system where this is executing, 8 CHAR

• --inCpmFlow (boolean)

  • Y if job is part of a CPM flow, N if not, 1 CHAR

• --insertRms (boolean)

  • Y if an RMS step will be inserted into this job's JCL, N if not, 1 CHAR

• --jclAllocErr | --jcl (boolean)

  • Y if JCL or PARM DATA library could not be allocated, N if not, 1 CHAR

• --jclCount (boolean)

  • The number of non-# records in the JCL or PARM DATA members associated with this job, INTEGER

• --jclError (boolean)

  • Y if job marked with JCL error, N if not, 1 CHAR

• --jclFromAltlib | --jcl (boolean)

  • Y if JCL or PARM DATA was retrieved from an alternate library, N if not, 1 CHAR

• --jclLibrary | --jcl (boolean)

  • Contains either a 3 digit JCL index value or a JCL variable beginning with an ampersand, 16 CHAR

• --jesHi (boolean)

  • JES supports ID > 99999, 1 CHAR

• --loadOnly (boolean)

  • Y if this is a LOAD only job, N if not, 1 CHAR

• --loadStepDone | --loa (boolean)

  • Y if LOAD step ran OK for this job, N if not, 1 CHAR

• --locked (boolean)

  • Y if job is locked, N if not, 1 CHAR

• --longName (boolean)

  • An alias name for this job. This name may be used by scheduling engines on other platforms, such as AutoSys, 64 CHAR

• --lterm (boolean)

  • Logical terminal name from job definition, 8 CHAR

• --mainid (boolean)

  • If positive, the CPU number on which the job may execute. If negative, the CPU number on which the job may not execute, INTEGER

• --maint (boolean)

  • Y if job ignores requirements, N if not, 1 CHAR

• --manualRequeue | --man (boolean)

  • Y if job has been re-queued to REQUEST queue, N if not, 1 CHAR

• --memberName | --mem (boolean)

  • The JCL or PARM DATA library member name, 8 CHAR

• --mustStartExists | --mus (boolean)

  • Determines if a zero value in MUST_START_TIME indicates midnight (Y) or no deadline time (N), 1 CHAR

• --needsAutof | --nee (boolean)

  • Y if a job changed and requires 'F' in CA11, N if not, 1 CHAR

• --nextRunReq | --nex (boolean)

  • Y if job has temporary requirements for the next execution, N if not, 1 CHAR

• --nodeFailed | --nod (boolean)

  • Y if this is an XPJOB job and at the time of it last submit its node was down, N if not, 1 CHAR

• --nodeOffline | --nod (boolean)

  • Y if this is an XPJOB job and at the time of its last submit its node was offline, N if not, 1 CHAR

• --nodeStopped | --nod (boolean)

  • Y if this is an XPJOB job and at the time of it last submit its node was stopped, N if not, 1 CHAR

• --noUserId (boolean)

  • Y if there is not a valid security id for this job, N if there is, 1 CHAR

• --noXpsiParmlib | --noX (boolean)

  • Y if this is an XPJOB job and has no PARMLIB, N if not, 1 CHAR

• --noXpsiXpsparm | --noX (boolean)

  • Y if this is an XPJOB job and has no PARM, N if not, 1 CHAR

• --override (boolean)

  • Y if JCL/PARM DATA override is required, N if not, 1 CHAR

• --overrideApplied | --ove (boolean)

  • Y if JCL overrides have been applied for this job, N if not, 1 CHAR

• --prompt (boolean)

  • Y if job should have LATE PROMPTS, N if not, 1 CHAR

• --promptAck (boolean)

  • Y if user has acknowledged the prompt, N if not, 1 CHAR

• --prompted (boolean)

  • Y if user has been prompted, N if not, 1 CHAR

• --qjclUpdated | --qjc (boolean)

  • Y if JCL or PARM DATA updated through QJCL, N if not, 1 CHAR

• --queueJcl (boolean)

  • Y if a QJCL command is in progress for this job N if not

• --repeatCount | --rep (boolean)

  • The number of times to repeat this job, INTEGER

• --repeatDiff | --rep (boolean)

  • The difference between the original dueout time and the original submit time, used by repeating jobs. The value is in minutes, INTEGER

• --repeatInterval | --rep (boolean)

  • The interval between repetitions of the job, PACKED

• --repeatLeadTime | --rep (boolean)

  • The lead time for this repeat job. This is the amount of time to ensure it completes before it due out time, PACKED

• --repeatStopExists | --rep (boolean)

  • Determines if a zero value in REPEAT_STOP_TIME indicates midnight (Y) or no repeat stop time (N), 1 CHAR

• --repeatStopTime | --rep (boolean)

  • The date and time on or after which a repeating job will not be repeated, DATE/TIME

• --repeatType | --rep (boolean)

  • The type of repeat job. This field determines how the submit time requierement is calculated for repeating jobs, 1 CHAR

• --restartStep | --res (boolean)

  • The step name in which the job was restarted, 8 CHAR

• --retainJcl (boolean)

  • Y if JCL or XPJOB information will be retained in the prior run queue, N if not, 1 CHAR

• --rqmtCount (boolean)

  • The master requirement count for this job. The number includes unsatisfied requirements, submit time, and other reasons preventing the job from being submitted, INTEGER

• --schdAdjusted | --sch (boolean)

  • Y if job's schedule has been adjusted, N if not, 1 CHAR

• --nosecurity | --nos (boolean)

  • Y if there was an error retrieving security data,N if no, 1 CHAR

• --setNdb (boolean)

  • Y if job will bypass LOAD processing at completion and not update the database, N if not, 1 CHAR

• --smfNeeded (boolean)

  • Y if SMF feedback is needed for this job, N if not, 1 CHAR

• --startTime (boolean)

  • The date and time this job started executing on its most recent submission, DATE/TIME

• --submitted (boolean)

  • Y if this job has been submitted to the host, N if not, 1 CHAR

• --submitTime | --sub (boolean)

  • The date and time this job was submitted, DATE/TIME

• --triggered (boolean)

  • Y if job triggered by another job, N if not, 1 CHAR

• --uid (boolean)

  • The CA 7 internal user security designation, INTEGER

• --verify (boolean)

  • Y if job has a manual verification requirement, N if not, 1 CHAR

• --waitSubmitTime | --wai (boolean)

  • Y if this job has a submit time requirement, N if not, 1 CHAR

• --xpAltNode (boolean)

  • The alternate node where this XPJOB job was routed, CHAR 64

• --xpPrimaryNode | --xpP (boolean)

  • The primary node associated with this XPJOB job, CHAR 64

• --xpsJob (boolean)

  • Y if this is an XPJOB job, N if not, 1 CHAR

• --xpStatus (boolean)

  • The status of the node associated with this XPJOB job. A: Active F: Failed CCI send O: Offline S:Stopped, 1 CHAR

• --xtrackerInact | --xtr (boolean)

  • Y if at time of submission, the XTRACKER task is not active for an XPJOB job or IAS is not active for an agent job, N if not, 1 CHAR

• --xplatNode (boolean)

  • Cross platform long node name, 64 CHAR

• --responseError | --res (boolean)

  • Response Error

• --ca11FailingStep# | --ca1 (boolean)

  • CA 11 Failing Step Number, INTEGER

• --completeOk | --com (boolean)

  • Y if job completed normally, N if not, 1 CHAR

• --jes# (boolean)

  • The JES job number for this job. A value of -1 indicates *NA*, INTEGER

• --needsLoad (boolean)

  • Y if LOAD processing will be done for this job, Nif not, 1 CHAR

• --deadline (boolean)

  • The date and time a job must be started by in order to meet its due out time, DATE/TIME

• --jclfrom254 | --jcl (boolean)

  • Y if JCL or XPJOB information will be retained in the prior run queue, N if not, 1 CHAR

• --prose# (boolean)

  • Number of the prose text associated with this job, or zero, INTEGER

• --scheduleId | --sch (boolean)

  • The schedule id for this execution, INTEGER

• --triggeringJob# | --tri (boolean)

  • The CA 7 internal job number of the job that triggered this job or job that created the data set that triggered this job, INTEGER

• --triggers (boolean)

  • Y if job can trigger other jobs, N if not, 1 CHAR

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

• List a CA 7 job (7777) information which resided in CA7DB database :

  • zowe ca7 job-instance list-custom --ca7no 7777 --db CA7DB --jobname TESTCA7 Copy