GETSYSWORD

GETSYSWORD returns a CHARACTER string that is the value of the requested system information.

>>-GETSYSWORD(x)-----------------------------------------------><

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

The ASID keyword returns the Address Space Identifier value in hexadecimal of the program that calls the built-in function.

The ACTINFO keyword returns a comma-delimited string that is the JOB accounting information specified in the jobcard. In combination with the MAXACTINFO keyword of the GETSYSINT built-in function, you can obtain the individual job accounting field information. The returned account information has a maximum length of 144 bytes. If the subparameter is enclosed in apostrophes, the apostrophes will not be included in the accounting information string. For example, given the jobcard:

//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.

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.