Coding Each AOF Rule Type › UNIX System Services Rules › Additional AOF Variables Available in a USS Process Event Rule

Additional AOF Variables Available in a USS Process Event Rule

In addition to the normal USS message AOF variables, the following variables are defined for USS process events only. The variables that begin with 'cr' are for the creating process information when a process creation event has occurred. These variables are null for a process termination event. The variables that begin with 'pr' are for the process that has been created or terminated.

The following USS rule process event REXX stem variables are available:

USS.CRALIAS

The alias name of the z/OS security user name associated with the creating process. This value is usually the same as USS.CRUSERID.

Data Type: Character, read-only

Sample Value: USSWIZ

USS.CRASID

The z/OS address space number in which the creating process is running.

Data Type: 2-byte binary (unprintable), read-only

Sample Value: '00AB'X

USS.CRJOBNAME

The z/OS job name of the address space in which the creating process is running.

Data Type: Character, read-only

Sample Value: TESTJOB1

USS.CRPGMNAME

The name of the z/OS program or HFS or zFS in compatibility mode path file name associated with the creating process.

Data Type: Character, read-only

Sample Value: /bin/sh

USS.CRPID

The USS process id number of the creating process.

Data Type: Integer, read-only

Sample Value: 123789

USS.CRUSERID

The z/OS security user name associated with the creating process

Data Type: Character, read-only

Sample Value: USSGURU

USS.PRALIAS

The alias name of the z/OS security user name associated with the process. This value is usually the same as USS.PRUSERID

Data Type: Character, read-only

Sample Value: USSWIZ

USS.PRASID

The z/OS address space number in which the process is running.

Data Type: 2-byte binary (unprintable), read-only

Sample Value: '00BA'X

OPSLOG Browse Column: ASID

USS.PRCREATE

The type of USS service that was used to create the process.

Data Type: Character, read-only

Possible Values:

• FORK-the USS fork service
• SPAWN-the USS spawn service
• ATEXEC-the USS attach_exec service
• ATEXMVS-the USS attach_execmvs service
• 1STCALL-the process was created when a program called any USS service function. When the task that caused the process to be created ends, the process ends.

Sample Value: FORK

USS.PRJOBNAME

The z/OS job name of the address space the process in which the process is running.

Data Type: Character, read-only

Sample Value: TESTJOB2

OPSLOG Browse Column: JOBNAME

USS.PRPGMNAME

The name of the z/OS program or HFS or zFS in compatibility mode path file name associated with the process.

Data Type: Character, read-only

Sample Value: /u/bin/myprog

USS.PRPID

The USS process id number of the created or terminated USS process.

Data Type: Integer, read-only

Sample Value: 147249

USS.PRTERM

The type of termination that ended the process.

Data Type: Character, read-only

Possible Values:

• TERM-Normal termination
• MEMTERM-the process is being terminated by address space termination.
• ABTERM-the process terminated abnormally

For process initialization events the value is always INIT.

Sample Value: TERM

USS.PRTIMESTMP

The date and time the process was created. Because process ID numbers can be reused by USS, the combination of process number and create time serve as a unique value to identify the process.

Data Type: 8-byte binary value in z/OS time-of-day clock format

Sample Value: 'B256FC206E6980AB'X

USS.PRUSERID

The z/OS security user name associated with the process

Data Type: Character, read-only

Sample Value: USSGURU

OPSLOG Browse Column: USERID