GETSYSWORD
GETSYSWORD returns a CHARACTER string that is the value of the requested system information.
- x
- A character expression that specifies the requested system information. The following are valid
keywords for x:
- ASID
- ACTINFO
- JESNODE
- JOBCLASS
- JOBNAME
- JOBNUMBER
- MSGCLASS
- PROCSTEP
- SMFID
- STEPNAME
- SYSNAME
- SYSNODE
- SYSPLEX
The ASID keyword returns the Address Space Identifier value in hexadecimal of the program that calls the built-in function.
//JOB44 JOB (D548-8686,'12/8/85',PGMBIN)
GETSYSWORD(ACTINFO) will return the
string: D548-8686,12/8/85,PGMBIN
For more information about the JOB accounting
information parameter, see the z/OS MVS JCL Reference.The JESNODE keyword returns the JES node name of the system for the program that calls the built-in function.
The JOBCLASS keyword returns the Job Class that is assigned to the batch job for the program that calls the built-in function.
The JOBNAME keyword returns the JOB or TASK name that calls the built-in function.
The JOBNUMBER keyword returns the JES JOBID that is assigned to the batch job for the program that calls the built-in function.
The MSGCLASS keyword returns the message class of the job for the program that calls the built-in function.
The PROCSTEP keyword returns the job step name that calls the JCL procedure, which has the step that executes the PL/I program. If it is not called from a JCL procedure, a null string is returned.
The SMFID keyword returns the SMFID (system identifier) of the system for the program that calls the built-in function.
The STEPNAME keyword returns the step name that calls the PL/I program.
The SYSNAME keyword returns the LPAR name of the system installation of the TSO/USS/Batch job that calls the built-in function.
The SYSNODE keyword returns the JES node name of the system for the program that calls the built-in function. The result is the same as using keyword JESNODE.
The SYSPLEX keyword returns the SYSPLEX name of the system installation of the TSO/USS/batch job that calls the built-in function.
If the GETSYSWORD built-in function is called from a CICS transaction, the JOB or TASK name that starts the CICS control region is returned for the JOBNAME, and the step that initializes the CICS control region is returned for the STEPNAME.