Contents of the file security exit parameter list

The file security installation-wide exit parameter list is mapped by macro and DSECT GFSAUSEC. Table 1 describes each field.

For configurations that use Internet Protocol Version 4, the client IP address is in field FEDSIA. If your configuration uses IP version 6, refer to field FEDSIA6 for the client IP address. When an IPv6 address is provided in FEDSIA6, FEDSIA takes a value of -1.

If the dhcp site attribute is specified for the NFS server to use dynamic client IP addresses, the contents of the client IP address field will be correct when the exit parameter list request is processed. However, the exit must not have any dependency on the persistence of the IP address value beyond the duration of the individual request. That IP address can change between requests.

Table 1. Format of the parameter list for the file security installation-wide exit
Field Name	Description	Contents
FEDSRQ	Request code	System request code set by the server before each call to this exit for these conditions. 4 Validate allocate request 8 Validate write request 12 Validate read request 16 Return the current settings of the security permissions
FEDSRC	Return code	Codes are generated and returned by the exit routine.
FEDSM	Client system name	Character string ended by a single byte containing X'00'.
FEDSIA	Client IP address	Number (32-bit Internet address). Contains -1 (X'0xFFFFFFFF) if an IPv6 address is provided in the FEDSIA6 field.'
FEDSU	Client user ID number	Number
FEDSG	Client group ID number	Number
FEDSMU	z/OS user ID	Character string padded with a blank at the end of the user ID, conforming to z/OS standards.
FEDSDN	MVS data set name	Character string ended by a single byte containing X'00'. This conforms to z/OS standards.
FEDSMN	MVS data set member name	Character string ended by a single byte containing X'00'. This conforms to z/OS standards.
FEDSXS	Address of UXB	Size and contents are installation dependent. Generated at the start of a user session or user login by the login exit routine.
FEDSXG	Address of GXB	Size and content are installation dependent. Generated at server initialization by the login exit routine.
FEDSTYPE	File Type	Address of fullword integer defining the data set organization: 0 Not used 1 Sequential 2 Partitioned 3 Direct 4 Reserved 5 VSAM (if unable to classify further) 6 VSAM ESDS 7 VSAM RRDS 8 VSAM KSDS 9 Reserved 10 Reserved
FEDSRPM	UNIX Permissions	UNIX file modes of type mode_t as defined by POSIX.
FEDSXD	Message supplied by this exit routine	Address of the message structure (see Structure of the file security exit message).
FEDSVERS	z/OS version number	Number (0x17 for z/OS V1R7)
FEDSIA6	Client IP address	Number (128-bit Internet address, for Internet Protocol version 6 users)
Note: Character strings are in upper-case EBCDIC.