z/OS UNIX file access attributes - Key = '8019'

DALPMDE specifies the file access attributes for the z/OS® UNIX file. You can code DALPMDE only when you also code the pathname (DALPATH) key.

You specify either
- The hex integers representing OCREAT alone
  or
- The hex integers representing both OCREAT and OEXCL
on the DALPOPT key,
And if
The file does not exist,

Then MVS™ performs an open() function. The options from DALPOPT, the pathname from the DALPATH key, and the options DALPMDE (if specified) are used in the open(). MVS uses the close() function to close the file before the application program receives control.

For status group options other than OCREAT and OEXCL, the description in this information assumes that the application passes the values to the open() function without modification. That is, this application uses dynamic allocation information retrieval (the DYNALLOC macro) to retrieve the value specified for PATHOPTS and passes the value to the open() function. The application program can ignore or modify the information specified in the JCL.

When you code DALPMDE, # must be 1 and LEN must be 4; PARM must contain one of the following values or an "inclusive OR" result from any combination of the following values:

Table 1. DALPMDE 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 specify a file access attribute allowing users in the owners access group read access to the z/OS UNIX file being dynamically allocated, code:

KEY    #     LEN   PARM
8019   0001  0004  00000020

Example: To specify 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, use the "inclusive OR"+ expression for SIWUSRSIRGRP: and code

KEY    #     LEN   PARM
8019   0001  0004  000000A0