Subarea node start option list

A VTAM® subarea node uses SSCP-SSCP, SSCP-PU, SSCP-LU, and LU-LU sessions to control communications in its network. It does not provide APPN function. Subarea nodes depend on routing definitions such as path, virtual route (VR) and explicit route (ER). For more information about VTAM in a subarea network, see the z/OS Communications Server: SNA Network Implementation Guide.

The example that follows illustrates the VTAM start options for A02. Not coding the NODETYPE start option is what makes this node a subarea node.

NETID, SSCPID, and SSCPNAME are required start options. HOSTPU is not required; however, it is recommended if you are using NetView®. The CONFIG start option identifies a unique name of the configuration list to be activated when VTAM starts.

The AUTHLEN start option indicates whether VTAM will pass the transmission priority specified by the entry LEN node to another LEN node. AUTHLEN=YES (the default value) specifies that it will.

AUTORTRY specifies whether adjacent node activation will cause a retry of pending automatic logon requests and, if it does, what kinds of adjacent nodes will cause such retries upon activation. AUTORTRY=AUTOCAP (the default value) specifies that such requests are retried only when an adjacent CDRM or an adjacent CP that supports automatic logon is activated.

The AUTOTI start option allows you to specify how often pending automatic logon requests owned by this host are retried. AUTOTI=0 (the default value) specifies that such requests are not retried periodically.

The CINDXSIZ start option specifies the maximum size of the CID and CONVID index tables. The new default value is 8176 bytes.

The CMPMIPS start option is used by VTAM to determine the amount of time the adaptive compression tables are in adaptive mode versus being static. The higher the value specified, the greater the amount of time spent in adaptive mode and, consequently, the more efficient the compression and the more CPU cycles that are consumed. CMPMIPS=50 provides the most effective beginning balance between compression efficiency and CPU usage. The CMPMIPS value is meaningful only if the value for CMPVTAM is greater than 1.

The CMPVTAM start option specifies the maximum compression level allowed for sessions involving the host's application programs. CMPVTAM=3 specifies that the medium adaptive compression table is to be used.

The DISCNTIM start option specifies the amount of time that VTAM delays deactivation of the SSCP-PU session when there are no outstanding LU-LU session requests. This option is valid only for PU types 2 and 2.1 that have DISCNT=DELAY specified on the PU definition statement. DISCNTIM=15 (the default value) specifies this amount of time as 15 seconds. The valid range of values for DISCNTIM is 1-65535. You can change the value of DISCNTIM with the MODIFY VTAMOPTS command while VTAM is running.

The DSPLYDEF start option limits the number of messages displayed when many types of DISPLAY commands are issued without the MAX or NUM operands. Therefore, DSPLYDEF=100 specifies 100 as the number of messages displayed in these cases. For more information about the DSPLYDEF start option, see the z/OS Communications Server: SNA Resource Definition Reference.

The DSPLYMAX start option sets the maximum value that can be specified for the DSPLYDEF start option and for the MAX or NUM operands on the commands to which the DSPLYDEF start option applies. DSPLYMAX=65535 (the default value) therefore sets 65535 as the maximum value that can be specified for the DSPLYDEF start option. The range of valid values is 1-65535. For more information about the DSPLYMAX start option, see the z/OS Communications Server: SNA Resource Definition Reference.

Wildcard values enable an operator to expand a display by substituting special symbols (for example, * and ?) to represent unspecified characters in the name of a resource. The DSPLYWLD=FULLWILD start option specifies that wildcards are permitted in DISPLAY commands from all network operators, and that wildcards are permitted in DISPLAY commands from program operator applications whose APPL or GROUP definition statements indicate DSPLYWLD=YES.

The DYNDLGMD start option specifies the name of a logon mode table entry used by default when the session SLU is a dynamic cross-domain resource and a logon mode table entry is not otherwise provided. In the start option list that follows, DYNDEFLT is specified as the name of this entry. You can change the DYNDLGMD value with the MODIFY VTAMOPTS command while VTAM is running. You can also override the DYNDLGMD value for a specific dynamic cross-domain resource with the MODIFY DEFAULTS or MODIFY RESOURCE command.

The DYNMODTB start option specifies the name of a logon mode table used to correlate each logon mode name with a set of session parameters for a dynamic cross-domain resource session SLU. In the start option list that follows, SMPDYNLM is specified as the name of this table. You can change the DYNMODTB value with the MODIFY VTAMOPTS command or the MODIFY TABLE,OPTION=LOAD,TYPE=MODETAB command while VTAM is running. You can also override this value for a specific dynamic cross-domain resource with the MODIFY TABLE,OPTION=ASSOCIATE,TYPE=MODETAB command. See Default logon mode table for dynamic CDRSCs for a sample default logon mode table for dynamic cross-domain resources.

The ENHADDR start option specifies whether VTAM can assign element addresses greater than 65535 (high-order addresses) to resources establishing sessions within this subarea. ENHADDR=NO (the default value) indicates that VTAM cannot assign such element addresses.

The FLDTAB start option specifies whether VTAM suppresses duplicate messages sent to the operator console or system hardcopy log and, if it does, whether to use the IBM-supplied message flooding prevention table or a user-specified table. FLDTAB=ISTMSFLD (the default value) indicates that VTAM uses the internal message flooding table supplied by IBM® to suppress duplicate messages.

The ISTCOSDF start option specifies the resource types that can use the ISTCOSDF logmode entry. This entry is used when the logmode name specified for the session is not found. ISTCOSDF=INDLU (the default value) indicates that ISTCOSDF is restricted to use by independent LUs.

The LIMINTCP start option specifies the number of seconds to retain free SNASVCMG sessions on limited resources for the control point. The CP SNASVCMG session is used for some network management flows. This option affect only network connections defined as limited resources. Network connections are defined as limited resources by specifying LIMRES=YES on the applicable GROUP, LINE, or PU definition statements.

The NSRTSIZE start option allows you to specify the SRT directory size for specific network identifiers. The size specified overrides the value specified on the OSRTSIZE start option.

The OSIEVENT start option specified here indicates that only network events associated with major nodes and LUs will be passed to CMIP services for evaluation.

The OSIMGMT start option enables support of CMIP applications on VTAM, including the VTAM topology agent. OSIMGMT=YES specifies that the VTAM topology agent code and the CMIP services code are to be loaded and activated for use.

The OSITOPO start option lets you control whether the VTAM topology agent reports logical lines to CMIP manager application programs. It also lets you control whether all CDRSCs are reported, or only all independent logical units. The OSITOPO start option in the following start option list specifies that no logical lines are to be reported (NOLLINES) and that all independent logical units, but no other CDRSCs, are to be reported (ILUCDRSC). These are the default values. You can change the value of OSITOPO with the MODIFY VTAMOPTS command while VTAM is running, with the following restriction. If you code OSIMGMT=NO, you can specify any value for OSITOPO on the command. But, if you code OSIMGMT=YES, you can specify only OSITOPO=ILUCDRSC and OSITOPO=NOLLINES.

The UPDDELAY start option specifies the maximum number of seconds the VTAM topology agent waits between checking the list of resources in transient states to determine whether updates for those resources should be sent to the topology manager. UPDDELAY=60 specifies that 60 seconds is the amount of time the VTAM topology agent waits.

The SRCHRED start option specifies whether this node can reduce searches for resources which are found to be unreachable. SRCHRED=OFF (the default value) specifies that this node does not reduce searches. You can change the SRCHRED value with the MODIFY VTAMOPTS command while VTAM is running.

The SWNORDER start option specifies the way VTAM locates a switched PU. SWNORDER=CPNAME (the default value) specifies that VTAM searches for a switched PU by the CPNAME first and then, if not yet found, by the station identifier (IDBLK and IDNUM operands on the PU definition statement for the switched major nodes).

The VFYRED start option specifies whether the node should attempt to perform resource verification reduction. VFYRED=YES indicates that LU 6.2 session initiation requests do not need to be delivered to the target LU. Using the VFYRED start option allows you to significantly reduce directed verification searches. For more information about the VFYRED start option, see the z/OS Communications Server: SNA Network Implementation Guide and the z/OS Communications Server: SNA Resource Definition Reference.

The TRACE,TYPE=BUF,ID=ISTTOPAG start option specifies that a VTAM buffer contents trace is to be started for the VTAM topology agent. The trace will show requests and responses to and from the VTAM topology agent. Make sure that GTF with the TRACE=USR option is active before starting this trace.

The TRACE,TYPE=BUF,ID=ISTNOTIF start option specifies that a VTAM buffer trace is to be started for notification services. The buffer trace will trace event notification activity between the VTAM topology agent and notification services of CMIP services. Make sure that GTF with the TRACE=USR option is active before starting this trace.

*  =====> BEGINNING OF DATA SET ATCSTR02
**********************************************************************
*   ATCSTR02 - VTAM START LIST FOR A SUBAREA NODE - SUBAREA A02      *
**********************************************************************
         AUTHLEN=YES,           ** WILL FORWARD TRANS PRIORITY      ** X
         AUTORTRY=AUTOCAP,      ** AUTOLOGON RETRY ACTIVATION VALUE ** X
         AUTOTI=0,              ** NO PERIODIC AUTOLOGON RETRIES    ** X
         CINDXSIZ=8176,         ** CIT & CONVT INDEX TABLE SIZE     ** X
         CMPMIPS=50,            ** ADAPTIVE COMPRESSION CPU USAGE   ** X
         CMPVTAM=3,             ** MEDIUM ADAPTIVE COMPRESSION TABLE** X
         CONFIG=02,             ** MAJOR NODE ACTIVATION CONFIG LIST** X
         DISCNTIM=15,           ** SSCP-PU DEACTIVATION DELAY       ** X
         DSPLYDEF=100,          ** DEFAULT VALUE FOR MAX AND NUM    ** X
         DSPLYMAX=65535,        ** MAXIMUM DSPLYDEF VALUE           ** X
         DSPLYWLD=FULLWILD,     ** WILDCARDS PERMITTED              ** X
         DYNDLGMD=DYNDEFLT,     ** DEFAULT LOGMODE FOR DYNAMIC CDRSC** X
         DYNMODTB=SMPDYNLM,     ** DEFAULT LOGMODE TABLE FOR DYNAMIC** X
         ENHADDR=NO,            ** NO HIGH-ORDER ELEMENT ADDRESSES  ** X
         FLDTAB=ISTMSFLD,       ** MESSAGE FLOODING PREVENTION      ** X
         HOSTPU=A02NPU,         ** HOST SUBAREA PU NETWORK NAME     ** X
         HOSTSA=02,             ** UNIQUE SUBAREA ADDRESS           ** X
         ISTCOSDF=INDLU,        ** ISTCOSDF RESOURCE TYPES          ** X
         LIMINTCP=29,           ** CP SNASVCMG LIMITED RESOURCE     ** X
         NETID=NETA,            ** HOST NETWORK IDENTIFIER          ** X
         NSRTSIZE=              ** SPECIFIC NET SRT SIZES           ** X
             (NETD,10,                                                 X
              NETE,11,                                                 X
              NETE,11,                                                 X
              NETF,12,                                                 X
              NETG,91,                                                 X
              NETH,97,                                                 X
              NETI,100,                                                X
              NETJ,110,                                                X
              NETL,2097148),                                           X
         OSIEVENT=MC,           ** SELECT EVENTS TO REPORT TO CMIP  ** X
         OSIMGMT=YES,           ** SUPPORT CMIP APPLICATIONS        ** X
         OSITOPO=(NOLLINES,     ** SELECT TOPOLOGY TO REPORT        ** X
                 ILUCDRSC),                                            X
         OSRTSIZE=43,           ** SRT SIZE FOR NON-NATIVE NETWORKS ** X
         UPDDELAY=60,           ** UPDATE DELAY IN SECONDS          ** X
         SRCHRED=OFF,           ** SEARCH REDUCTION SETTING         ** X
         SSCPID=02,             ** UNIQUE SSCP IDENTIFIER           ** X
         SSCPNAME=A02N,         ** GATEWAY SSCP NAME                ** X
         SWNORDER=CPNAME,       ** SWITCHED PU SEARCH ORDER         ** X
         VFYRED=YES,            ** LU 6.2 VERIFICATION REDUCTION    ** X
         TRACE,                                                        X
           TYPE=BUF,                                                   X
           ID=ISTTOPAG,         ** TRACE FOR TOPOLOGY AGENT         ** X
           AMOUNT=FULL,         ** FULL NEEDED FOR ISTTOPAG         ** X
           ID=ISTNOTIF,         ** TRACE FOR NOTIFICATION SERVICES  ** X
           AMOUNT=FULL          ** FULL NEEDED FOR ISTNOTIF         ** X
*  =====> END OF DATA SET ATCSTR02