Running RACF commands

The R_admin run-command function accepts a command image that your application has constructed, and executes this command in the RACF® subsystem address space. It can be invoked by problem state callers.

Output, if any, which resulted from RACF's processing of the command is returned to the caller in virtual storage. There is a maximum of 4096 lines (not bytes) of output which will be returned by R_admin.

Run-command does not support all RACF commands. For a list of the commands that are not allowed by this service, see Usage notes.

The exact format (spacing and order) of the data in the command output or messages does not constitute a programming interface. No programs should depend on the exact format of this data. The R_admin extract functions, described below, provide a programming interface with which to retrieve RACF profile data for some profile types. The extract functions are not subject to the 4096 limit on output lines.

For the ADMN_RUN_COMD (run-command) function code, the structure associated with the function-specific parameter list is mapped as follows:

Table 1. Parameter list format for running a command
Offset	Length	Description
0	2	Length of the RACF command string. Note, the length must not exceed 4096 characters.
2	*	Syntactically correct RACF TSO administration command string.

The command string must be left-justified within the input buffer.

The output from run-command is either command output or error messages. The output format is shared with the R_admin update functions and is documented in Command output message block mapping.