z/OS Communications Server: SNA Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Environment vector list

z/OS Communications Server: SNA Customization
SC27-3666-00

The environment vector list provides information specific to the host in which the exit is operating. The information includes the network ID, the SSCP name, and other information that identifies the environment in which the exit routine is operating. The vector list is preceded by a 2-byte length field.

Table 1. Environment vectors

 

Dec (Hex)
Offset

Size
(Bytes)

 
Description

A header precedes the list of vectors:
  0 (0) 2 Total length of the parameter list including this length field (m)
This header is followed by several vectors, which can be in any order.
The network identification vector:
  0 (0) 1 Length of the vector including this field (n)
  1 (1) 1 ID of the vector (X'06')
  2 (2) n-2 ID of the network in which this exit routine is operating (from the NETID start option)
The SSCP name vector:
  0 (0) 1 Length of the vector including this field (n)
  1 (1) 1 ID of the vector (X'07')
  2 (2) n-2 SSCP name of the host in which this exit is operating. The start option SSCPNAME is required.
The host PU name vector:
  0 (0) 1 Length of the vector including this field (n)
  1 (1) 1 ID of the vector (X'08')
  2 (2) n-2 Name of the host in which this exit is operating (from the HOSTPU start option)
The host PU network address vector:
  0 (0) 1 Length of the vector including this field
  1 (1) 1 ID of the vector (X'09')
  2 (2) 6 Network address of the host PU
The OLU adjacent network vector is used for the following functions:
  • Initial authorization
  • Secondary authorization
  • Initial accounting
  • Final accounting
  • XRF session switch
  • ALS selection
0 (0) 1 Length of the vector including this field (n)

If this information is not applicable, the length field contains X'00' and the actual length of the vector is X'01'.

  1 (1) 1 ID of the vector (X'0A')
  2 (2) n-2 Network name of the adjacent network in the OLU direction1
The DLU adjacent network vector is used for the following functions:
  • Initial authorization (for INIT OTHER CD)
  • Secondary authorization
  • Initial accounting
  • Final accounting
  • XRF session switch
  • Alias selection
  • ALS selection
0 (0) 1 Length of the vector including this field (n)

If this information is not applicable, the length field contains X'00' and the actual length of the vector is X'01'.

  1 (1) 1 ID of the vector (X'0B')
  2 (2) n-2 Network name of the adjacent network in the DLU direction1
The VTAM® release vector:
  0 (0) 1 Length of the vector including this field (n)
  1 (1) 1 ID of the vector (X'0D')
  2 (2) 1 VTAM product code
  3 (3) 1 VTAM version code
  4 (4) 1 VTAM release code
  5 (5) 1 VTAM modification code
Notes:
  1. The network ID of this host is used if any of the following is true:
    • The resource is in this domain.
    • The adjacent SSCP in the direction of the resource is in this network.
    • This host is not a gateway SSCP.
  2. The network ID adjacent to this network in the direction of the resource is used if both of the following are true:
    • The adjacent SSCP in the direction of the resource is cross-network.
    • This is a gateway SSCP.
 

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014