gtpo1mb7 | Operations |
Use this command to display or change the value of the fields in the SNA communications keypoint (CTK2).
Requirements and Restrictions
None.
Format
|
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.
|
|
|
|
CTCWBFRS | Display the number of 4-KB output buffers that the TPF system allocated
for sending data to CTC link stations.
|
|
|
|
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.
| 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