Exit Point QIBM_QNPS_ENTRY is used by exit programs that want to control which users can access the network print server. The called exit program is passed two parameters. These parameters are pointers to structures in user domain storage. These structures, collectively, comprise format ENTR0100.
Required parameters
Required parameter group
1 Return code Output CHAR(1) 2 Server information Input CHAR(32)
- Return code
- OUTPUT; CHAR(1) The return code parameter is a pointer to a structure in user domain that contains the return code from the exit program. The return code is checked on return from the call to the exit program.
A return code value of hexadecimal F1 indicates that the network print server allows access and continues processing.
Any other return code value indicates that the network print server rejects access and stops processing. The exit program being called must log any specific errors.
The structure of the return code follows
Offset Type Field Dec Hex 0 0 CHAR(1) Return code
- Server information
- INPUT; CHAR(32) The server information structure contains the user profile name, server identifier, format name, and server function identifier.
The structure of the server information follows
Offset Type Field Dec Hex 0 0 CHAR(10) User profile name 10 A CHAR(10) Server identifier 20 14 CHAR(8) Format name 28 1C BINARY(4) Function identifier
Parameter field descriptions
- Format name
- The name of the format being used. For entry support the value is ENTR0100.
- Function identifier
- This parameter identifies, within a server, the function of the exit point. For entry support, the value is hexadecimal 0802.
- Server identifier
- This parameter identifies the i5/OS server being called. The value for the network print server is QNPSERVR.
- User profile name
- The user, from IBM eServer iSeries Access for Windows, that is making the call to the network print server.