Central server

 

Identify i5/OS™ exit points for the central server. The central server has three exit points defined:

  1. QIBM_QZSC_LM format ZSCL0100

  2. QIBM_QZSC_SM format ZSCS0100

  3. QIBM_QZSC_NLS format ZSCN0100

The QIBM_QZSC_LM exit point is defined to run an exit program for all license management requests received by the central server.

Exit program QIBM_QZSC_LM format ZSCL0100

Offset Type Field Description
Dec Hex
0 0 CHAR(10) User profile name The name of the user profile that is calling the server
10 A CHAR(10) Server identifier For the central server, the value is *CNTRLSRV.
20 14 CHAR(8) Format name The user exit format name being used. For QIBM_QZSC_LM, the format name is ZSCL0100.
28 1C BINARY(4) Requested function The function being performed

This field contains one of the following:

  • X'1001' - Request license

  • X'1002' - Release license

  • X'1003' - Retrieve license information
32 20 CHAR(255) Unique client name The unique client name is used to identify a specific workstation across a network. The use of a licensed product is assigned to a workstation identified by the unique client name.
287 11F CHAR(8) License user handle License user handle is used to ensure that the license requester and license releaser are the same. This value must be the same as when the license was requested.
295 127 CHAR(7) Product identification The identification of the product whose licensed use is requested
302 12E CHAR(4) Feature identification The feature of the product
306 132 CHAR(6) Release identification The version, release, and modification level of the product or feature
312 138 BINARY(2) Type of information The type of information to be retrieved.

The type of information field is only valid for the retrieve license information function

This field contains one of the following:

  • X'0000' - Basic license information

  • X'0001' - Detailed license information

This format is defined by member EZSCEP in files H, QRPGSRC, QRPGLESRC, QLBLSRC and QCBLLESRC in library QSYSINC.

The QIBM_QZSC_SM exit point is defined to run an exit program for all client management requests received by the central server.

Exit program QIBM_QZSC_SM format ZSCS0100

Offset Type Field Description
Dec Hex
0 0 CHAR(10) User profile name The name of the user profile that is calling the server
10 A CHAR(10) Server identifier For the central server, the value is *CNTRLSRV.
20 14 CHAR(8) Format name The user exit format name being used. For QIBM_QZSC_SM the format name is ZSCS0100.
28 1C BINARY(4) Requested function The function being performed

This field contains one of the following:

  • X'1101' - Set client active

  • X'1102' - Set client inactive
32 20 CHAR(255) Unique client name The client workstation name that is assigned to the licensed product
287 11F CHAR(255) Community name The community name SNMP configuration field is used for authentication.
542 21E CHAR(1) Node type The type of connection

  • 3 - Internet
543 21F CHAR(255) Node name The name of the node

For node type 3, the node name will be an Internet address.

This format is defined by member EZSCEP in files H, QRPGSRC, QRPGLESRC, QLBLSRC and QCBLLESRC in library QSYSINC.

The QIBM_QZSC_NLS exit point is defined to run an exit program when the central server receives a request to retrieve a conversion map.

Exit program QIBM_QZSC_NLS format ZSCN0100

Offset Type Field Description
Dec Hex
0 0 CHAR(10) User profile name The name of the user profile that is calling the server
10 A CHAR(10) Server identifier For the central server, the value is *CNTRLSRV.
20 14 CHAR(8) Format name The user exit format name being used. For QIBM_QZSC_NLS, the format name is ZSCN0100.
28 1C BINARY(4) Requested function The function being performed

  • X'1201' - Retrieve conversion map
32 20 BINARY(4) From coded character set identifier (CCSID) CCSID for existing data
36 24 BINARY(4) To coded character set identifier (CCSID) CCSID into which the data will be converted
40 28 BINARY(2) Type of conversion Requested mapping type:

  • X'0001' - Round trip

  • X'0002' - Substitution mapping

  • X'0003' - Best-fit mapping

This format is defined by member EZSCEP in files H, QRPGSRC, QRPGLESRC, QLBLSRC and QCBLLESRC in library QSYSINC.

 

Parent topic:

Exit program parameters