JITOKEN

The JITOKEN (JIT) service provides a method for uniquely referencing the same job instance over time.

Related topic

Services

Given a job name (or an ASID), the JITOKEN service returns a unique token that can be used in any subsequent service that accepts a job name as a parameter. Job Instance Tokens always begin with a colon (:).

Note

Some BMC AMI Ops SYSPROG Services users utilize BMC AMI Ops Automation or another automation product to help automate their operations. Occasionally, a user might need to determine whether a specific job is still executing. One method is to issue the STATUS command with the subject address space; this method produces a minimum amount of output--one line of output if the identified job exists, or a one-line message if the job is not found. However, the STATUS service might not locate the desired instance; therefore, you should use the JITOKEN service, instead.

Syntax

GUID-B38572AA-5D36-4E46-8AC2-CC7B8903D6D8-low.pngThe parameter is defined as follows:

Parameter

Description

asi

Address space instance; see Identifying-address-spaces for more information

Example

To display the Job Instance Token and other information for XTST6PAS, type

JIT,XTST6PAS

AMTJT1I Jobname=XTST6PAS.PAS6 ASID=223 (X00DF) Token= :05SYMY4 [1]
 AMTJT3I STEP=PAS6 STOKEN= 0000037C00000001 Owner=MVSSTC [2]
 AMTJT4I Initiated Friday, May 25, 2012; 10:57:29.20 PM Local[3]
 AMTJT5I Elapsed time=10:51:18.180 (in hours, minutes and seconds)[4]
 AMTJT6I SrvClass=STCNRM [5]
 AMTJT8I AcntData=

Legend:

  1. Information that identifies the job (displayed only if the address space is a started task, and the started task ID differs from the job name), as follows:
    • Job name and started task ID, separated by a period
    • Address space's ASID in decimal format and hexadecimal format (the latter starting with X and enclosed in parentheses)
    • Unique token assigned to this job instance
  2. Current step name, followed by the address space token, followed by the owner
  3. Day, date, and time when the job instance was initiated
  4. Amount of time since the job instance was initiated
  5. Current service class for the job instance

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*