gtpo1mb7Operations

ZNKEY-Display/Alter the SNA Communications Keypoint

Use this command to display or change the value of the fields in the SNA communications keypoint (CTK2).

Note:
Not all of the fields in CTK2 can be changed using the ZNKEY command. See Table 12 for more information.

Requirements and Restrictions

None.

Format




ALL
displays the value of all the fields in the CTK2 keypoint.

keyword
is the name of the field in CTK2 that you want to display or change. See Table 12 for a list of valid fields and descriptions.

value
is the new value you want to assign to the specified field. If you do not specify a value for this parameter, the current value is displayed.

The following table describes the fields in the CTK2 keypoint that you can display or change.

Table 12. Description of the Fields in the SNA Communications Keypoint (CTK2)

Field Description Minimum Value Maximum Value Change Takes Effect
CLAWADP Display the current value for the number of Common Link Access to Workstation (CLAW) adapters that you can define for TCP/IP offload support.


CLAWFD Display the current value for the number of file descriptors that you can define for TCP/IP offload support.


CLAWIP Display the current value for the number of local Internet Protocol (IP) addresses that you can define for TCP/IP offload support.


CPNAME Display the control point name (CPNAME) of the TPF system. This field is only defined when the TPF system is running in LEN mode. This field is not defined when the TPF system is running in APPN mode.


CTCANS Display or change the number of seconds that the TPF system waits before declaring the other side inoperative. This is equivalent to the NCP Automatic Network Shutdown (ANS) or VTAM Missing Interrupt Handler (MIH) functions. 2 32 767 Immediately
CTCRBFR Display the number of 4-KB input buffers that the TPF system allocated for receiving data from CTC link stations.
Note:
This indicates the number of input buffers per CTC link.



CTCWBFRS Display the number of 4-KB output buffers that the TPF system allocated for sending data to CTC link stations.
Note:
This indicates the number of total output buffers for all CTC links.



CTCTGANY Always displays YES, which indicates that the TPF system supports any transmission group (TG=ANY) on CTC links.


DYNTO Display or change the recycle time for an RVT entry. The recycle time is the minimum amount of time that an RVT entry must remain on the RVT termination list before it can be reused by a new LU. 0 65 535 Immediately
FMHDR Display the FM header data that prefixes the system-generated messages to 3600 LUs.


HARDREC Display or change whether the TPF system should resynchronize the virtual route (VR) sequence number for each Network Control Program (NCP) that uses FID4 following a software or hardware initial program load (IPL). Yes or No
Immediately
HPFMMR Display whether or not the base system is using the high performance functional management message router (HPFMMR) transmit process.


HPRALIVE Display or change the value of the high-performance routing (HPR) alive timer. See TPF ACF/SNA Data Communications Reference for more information about the alive timer. 1 65 535 Next restart
HPRMTSIZ Display the number of 4-KB frames in the high-performance routing message table (HPRMT). See TPF ACF/SNA Data Communications Reference for more information about the HPRMT.


HPRPST Display or change the value of the high-performance routing (HPR) path switch timer. See TPF ACF/SNA Data Communications Reference for more information about the path switch timer.
Note:
Once the value of the path switch timer is set for a rapid transport protocol (RTP) connection, it is used for the life of that RTP connection. Therefore, when you specify a new value for this parameter, that new value is used only for new RTP connections that are started. Existing RTP connections continue to use the original value of the path switch timer.
1 65 535 Immediately
ILWPC Display or change the percentage of common blocks that must be available in the TPF system. If the percentage falls below this value, the TPF system will not perform certain functions that require common blocks, such as sending virtual route (VR) pacing responses, until the minimum percentage is available again. This helps the TPF system avoid running out of critical resources.

This parameter is also used by adaptive rate-based (ARB) pacing to regulate the rate at which traffic is sent across rapid transport protocol (RTP) connections. See TPF ACF/SNA Data Communications Reference for more information about ARB pacing and RTP connections.

If you specify a value of 0 for this parameter, the TPF system will not check the percentage of common blocks available and will use a default value to calculate ARB pacing.

0 99 Immediately
ILWPE Display or change the percentage of entry control blocks (ECBs) that must be available in the TPF system. If the percentage falls below this value, the TPF system will not perform certain functions that require common blocks, such as sending virtual route (VR) pacing responses, until the minimum percentage is available again. This helps the TPF system avoid running out of critical resources.

This parameter is also used by adaptive rate-based (ARB) pacing to regulate the rate at which traffic is sent across rapid transport protocol (RTP) connections. See TPF ACF/SNA Data Communications Reference for more information about ARB pacing and RTP connections.

If you specify a value of 0 for this parameter, the TPF system will not check the percentage of ECBs available and will use a default value to calculate ARB pacing.

0 99 Immediately
ILWPF Display or change the percentage of frame blocks that must be available in the TPF system. If the percentage falls below this value, the TPF system will not perform certain functions that require common blocks, such as sending virtual route (VR) pacing responses, until the minimum percentage is available again. This helps the TPF system avoid running out of critical resources.

This parameter is also used by adaptive rate-based (ARB) pacing to regulate the rate at which traffic is sent across rapid transport protocol (RTP) connections. See TPF ACF/SNA Data Communications Reference for more information about ARB pacing and RTP connections.

If you specify a value of 0 for this parameter, the TPF system will not check the percentage of frame blocks available and will use a default value to calculate ARB pacing.

0 99 Immediately
ILWPI Display or change the percentage of input/output blocks (IOBs) that must be available in the TPF system. If the percentage falls below this value, the TPF system will not perform certain functions that require common blocks, such as sending virtual route (VR) pacing responses, until the minimum percentage is available again. This helps the TPF system avoid running out of critical resources.

This parameter is also used by adaptive rate-based (ARB) pacing to regulate the rate at which traffic is sent across rapid transport protocol (RTP) connections. See TPF ACF/SNA Data Communications Reference for more information about ARB pacing and RTP connections.

If you specify a value of 0 for this parameter, the TPF system will not check the percentage of IOBs available and will use a default value to calculate ARB pacing.

0 99 Immediately
ILWPS Display or change the percentage of system work blocks (SWBs) that must be available in the TPF system. If the percentage falls below this value, the TPF system will not perform certain functions that require common blocks, such as sending virtual route (VR) pacing responses, until the minimum percentage is available again. This helps the TPF system avoid running out of critical resources.

This parameter is also used by adaptive rate-based (ARB) pacing to regulate the rate at which traffic is sent across rapid transport protocol (RTP) connections. See TPF ACF/SNA Data Communications Reference for more information about ARB pacing and RTP connections.

If you specify a value of 0 for this parameter, the TPF system will not check the percentage of SWBs available and will use a default value to calculate ARB pacing.

0 99 Immediately
INREC Display or change whether or not a safe store file copy of recoverable input messages should be created. Yes or No
Immediately
IPMTSIZE Display the size of the Internet Protocol (IP) message table (IPMT) in 4-KB blocks.


IPRBUFFS Display the number of read buffers assigned to each read channel program for an IP router using channel data link control (CDLC) support.


IPRBUFSZ Display the size of each read buffer for IP routers using channel data link control (CDLC) support.


IPTOS Display or change the type of service (TOS) value to use for the network priority of outbound TPF IP packets. 0 255 Immediately
IPTRCNUM Display the maximum number of individual IP traces that can be defined.


IPTRCSIZ Display the size of each individual IP trace table, defined in 4-KB blocks.


LENNETID Display the network ID used by the TPF system when it is attached as a PU 2.1 node.


LMSCTI Display or change the time interval, in seconds, that is used to notify the logon manager (LM) of the number of sessions active through an ALS. 1 32 767 Next restart
LUBLKT Display or change the time interval before the LU blocking package transmits queued output data. The time unit for the value that you specify is double the value of SNAPOLL. 1 100 Immediately
MAXALS Display the maximum number of channel-attached 37x5 and 3174 devices that can be physically attached to the TPF system and running at the same time.


MAXASCU Display or change the maximum number of Mapping of Airline Traffic over Internet Protocol (MATIP) agent set control units (ASCUs) that may be connected to the TPF system at one time. 0 16 777 215 Next restart
MAXBFRU Display the number of input buffers allocated by the TPF system to receive data from channel-attached 37x5 devices.


MAXCCB Display the number of conversation control block (CCB) entries in the TPF system.


MAXCDRSC Display the maximum number of cross-domain resources by processor.


MAXCTC Display the maximum number of channel-to-channel (CTC) links that can be active simultaneously.


MAXHCT Display or change the maximum number of hotcon table (HCT) entries that the TPF system can maintain between relational databases and the TPFAR feature. This value must be MAXCCB-2 + MAXSOCK. 0 65 535 Next restart
MAXHPRSA Display the number of entries in the high-performance routing session address table (HPRSAT). This is the maximum number of high-performance routing (HPR) LU-LU sessions per TPF processor. See TPF ACF/SNA Data Communications Reference for more information about the HPRSAT.


MAXIPCCW Display the maximum number of IP routers that can be active on this TPF host.


MAXMATIP Display or change the maximum number of MATIP sessions that can exist at one time. 0 16 777 215 Next restart
MAXOSA Display the maximum number of Open Systems Adapter (OSA)-Express connections that can be active on the TPF system.


MAXPCID Display the number of procedure correlation ID (PCID) table entries in the TPF system.


MAXPRIM Display the number of resource name hash prime table (RNHPT) entries defined in the TPF system.


MAXRTE Display or change the maximum number of IP routing table entries. 0 2 048 Next restart
MAXRTPCB Display the number of entries in the rapid transport protocol control block (RTPCB) table. This is the maximum number of RTP connections per TPF processor. See TPF ACF/SNA Data Communications Reference for more information about the RTPCB table.


MAXRVT Display the maximum number of SNA resources that can be defined for the TPF system.


MAXSCB Display the maximum number of session control blocks (SCBs) that are defined to the TPF system for TPF/APPC sessions.


MAXSDD Display or change the maximum number of structured query language (SQL) database management systems (DBMS) that are defined to the TPF system in the ZSQLD commands. 0 80 Next restart
MAXSID Display the maximum number of LEN sessions that can flow through any channel-attached 37x5 or 3174 device.


MAXSMTB Display or change the number of 4 KB storage areas that are used per I-stream to hold the SQL trace information. 0 5 Next restart
MAXSNF Display the number of slots in the sequence number field table.


MAXSOCK Display the maximum number of sockets that can be active on this TPF host using TCP/IP native stack support.


MAXSRT Display the number of system recovery table (SRT) entries generated in a processor.


MAXTPI Display the number of transaction program instance control block (TPICB) entries that can be active in a TPF system.


MQITRC Display the size of the Message Queue Interface (MQI) trace table. The size of the table is represented in 4-KB page units.


NETID Display the network ID used by the TPF system when it is attached as a PU 5 node.


NBLKLU Display the number of control blocks available for blocking output messages that are destined for General Access to X.25 Transport Extensions (GATE)/Fast Transaction Processing Interface (FTPI) resources.


NUMALS Display the number of non-LU entries that are allocated in the resource vector table (RVT).


OLDAPPL Display or change whether the TPF system should support old applications and SNA 3270 terminals, and bypass the restriction for multiple chained output message segments. Yes or No
Immediately
OSABUFF Display the number of 64-KB read buffers assigned to each OSA-Express connection.


PARACOS Display the class of service name that the TPF system uses while building a CDINIT response for a TPF/APPC parallel session.


PIUTAPEQ Display or change the tape queue threshold value for writing the PIU trace table to a real-time tape. 20 255 Immediately
RECIT Display or change the activation frequency of the SNA input recovery timeout program. The default timeout value is m × sec, where m specifies the multiplier used to calculate the recovery timeout, and sec specifies the resolution factor, in seconds, to calculate the recovery timeout. 1,1 255,255 Next restart
RECOP Display or change the number of seconds that the TPF system waits for a response to an output data message to a 3270 printer before taking recovery action. 1 32 767 Next restart
RECOT Display or change the number of seconds that the TPF system waits for a response to an output data message before taking recovery action. 1 32 767 Next restart
RSPTO Display or change the number of seconds that the TPF system waits for a response to a SNA command before the response is considered lost. 1 32 767 Next restart
RTPRSYNC Display or change whether the TPF system will use the rapid transport protocol (RTP) connection resynchronization process to attempt to keep RTP connections active after a hard initial program load (IPL) is performed. See TPF ACF/SNA Data Communications Reference for more information about the RTP connection resynchronization process. Yes or No
Immediately
RVTCTRL Display or change the number of RVT entries that are processed before giving up control of the CPU during the process of keypointing, validating, and timing out the entries. 0 8 388 607 Immediately
SINGMODE Display the mode name used for TPF/APPC single sessions initiated by the TPF system.


SLOWTIME Display or change the amount of time, in SNA polling intervals, that an adjacent link station (ALS) is allowed to be in slowdown before the TPF system deactivates the link. The SNAPOLL parameter defines the SNA polling interval. The SLOWTIME parameter also defines the amount of time, in 10-ms intervals, that an Internet Protocol (IP) router is allowed to be in slowdown mode before the TPF system deactivates the link. 0 32 767 Immediately
SNAPOLL Display or change the SNA polling interval. The value can range from 1 to 5, where 1 represents 10 milliseconds (ms), 2 represents 20 ms, and so on, up to a maximum of 50 ms. 1 5 Immediately
SNDWN Display or change the SNA shutdown level. If the number of available system work blocks (SWBs) in the TPF system falls below the number specified for this parameter, RVT scan will not issue any command. This value must be less than the value defined for the SNRST parameter. 11 32 766 Immediately
SNKEY Display or change the time interval, in seconds, at which the SNA keypointable control blocks, for example, resource vector tables (RVTs), are written to file. 1 32 767 Next restart
SNQDPT Display or change the SNA output queue depth. 8 50 Immediately
SNRST Display or change the SNA restart level. After the shutdown level is reached, this number specifies the number of SWBs that must be available in the TPF system before RVT scan can issue any commands. This value must be greater than the value defined for the SNDWN parameter. 12 32 767 Immediately
SNSESZ Display the size of the in-core sense table.


SNSETO Display or change the time, in seconds, that the TPF system collects negative responses before issuing a sense message that indicates the total number of negative responses received during this time period. 0 360 Next restart
SOCKSWP Display or change the interval, in minutes, in which the TCP/IP socket sweeper or the Secure Sockets Layer (SSL) sweeper will issue a CRETC macro to itself to close any inactive sockets. If you specify 0, the TCP/IP socket sweeper and the SSL sweeper are activated, but they do not close any inactive sockets or inactive shared SSL sessions. If you specify a value less than 3 but greater than 0, the CRETC interval is 3. 0 60 Immediately
SSLPROC Display the number of SSL daemon processes. 0 16
SSLTHRD Display or change the number of thread ECBs per SSL daemon process. 0 32 Next restart of the SSL daemon
TPALLOC Display or change the number of seconds that the TPF system waits for a remote LU to respond to a TPF/APPC ALLOCATE verb before timing out. 1 32 767 Immediately
TPRECV Display or change the number of seconds that the TPF system waits for data after a TPF/APPC RECEIVE verb, or any verb that implies CONFIRM, before timing out. 1 32 767 Immediately
TPWAIT Display or change the number of seconds that the TPF system waits for the remote LU to send information to any of the specified TPF/APPC conversations before timing out the TPPCC wait verb. 1 32 767 Immediately
TRANA Display or change whether the user-written transaction analysis exit must be called for each input message. Yes or No
Immediately
TRACSZ Display the size of the PIU trace table. The size of the table is represented in 4 KB page units.


UNITSZ Display the size of the TPF input buffer used for transferring data from a 37x5 device.


VRRTO Display or change the timeout value, in seconds, for virtual route (VR) resynchronization. 0 120 Immediately

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZNKEY HELP

ZNKEY ?

Examples

The value of the MAXALS field is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNKEY MAXALS                                                            |
|                                                                                |
|System: NKEY0023I 08.51.28 CPUID C                                              |
|        MAXALS   - 0000010                                                      |
+--------------------------------------------------------------------------------+

The value of the SNKEY field is changed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNKEY SNKEY-250                                                         |
|                                                                                |
|System: NKEY0025I 08.52.05 CPUID C                                              |
|        SNKEY    - 250           WAS 0000060                                    |
+--------------------------------------------------------------------------------+

Related Information