Return z/OS UNIX file access attributes - Key = 'C019'

DINRPMDE requests the return of the file options for the z/OS® UNIX file being dynamically allocated.

When you code DINRPMDE, # must be 1 and LEN must be at least 4 and can be longer, and the PARM field must be the length specified by the value in LEN.

If there are file options associated with the allocation, the system returns the file options in PARM and 0004 in LEN. PARM will contain one of the following values or an "inclusive or" result from any combination of the following values:

Table 1. DINRPMDE Attributes
Four-byte Hex Integers	JCL Equivalent
X'00000800'	SISUID
X'00000400'	SISGID
X'00000100'	SIRUSR
X'00000080'	SIWUSR
X'00000040'	SIXUSR
X'000001C0'	SIRWXU
X'00000020'	SIRGRP
X'00000010'	SIWGRP
X'00000008'	SIXGRP
X'00000038'	SIRWXG
X'00000004'	SIROTH
X'00000002'	SIWOTH
X'00000001'	SIXOTH
X'00000007'	SIRWXO

Example: To request the return of the z/OS UNIX file access attributes for /u/myuid/myapp/scr.dat, code:

Input:

KEY    #     LEN   PARM
8017   0001  0016  61 A4 61 94 A8 A4 89 84 61 94 A8 81 97 97 61 A2 83 99 4B 84 81 A3
C019   0001  0004  00000000

Output:

KEY    #     LEN   PARM
C019   0001  0004  000000A0

The retrieved information indicates a file access attribute allowing the owner of the file to write the file and users in the same file group class to read the file (the "inclusive OR" expression for SIWUSR+SIRGRP).