MODIFY TABLE command

Change resource associations or load a new table and associate it with a resource (other than a CoS table):

Change resource association with a CoS table or load a new CoS table and associate it with a resource:

Delete resource associations:

Load a table to replace an existing table (other than a filter table):

Load a filter table to replace an existing filter table:

Load an updated directory definition file:

Abbreviations

Operand	Abbreviation
MODIFY	F
NETID=name	NET=name
NEWTAB=name	NEW=name
OLDTAB=name	OLD=name
OPTION	OPT
OPTION=ASSOCIATE	OPT=ASSOC
OPTION=DELETE	OPT=DEL
TYPE=ASLTAB	TYPE=ASL
TYPE=COSTAB	TYPE=COS
TYPE=FLDTAB	TYPE=FLD
TYPE=LOGTAB	TYPE=LOG
TYPE=MDLTAB	TYPE=MDL
TYPE=MODETAB	TYPE=MODE
TYPE=USSTAB	TYPE=USS

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for OPTION=DELETE, code only OPT=DEL. Do not code OPTION=DEL.

Purpose

The MODIFY TABLE command dynamically loads VTAM® tables, changes VTAM table associations, or both. This command also disassociates resources from tables. MODIFY TABLE does not affect existing sessions with the resource named on the ID operand or its subordinate nodes. Only new sessions established after this command is issued are affected. The MODIFY TABLE command supports the following types of tables:

Associated LU
Class of Service
CMIP services directory definition file
Interpret
Logon mode
Message-flooding prevention
Model name
Session awareness data filter
USS

Note: Do not use the MODIFY TABLE command for the APPN Class of Service definitions. Use the VARY ACT command to activate the file containing the updated definitions.

The MODIFY TABLE command does not change the value of the DLOGMOD operand. To change the value of the DLOGMOD operand, see the MODIFY DEFAULTS command or the MODIFY RESOURCE command.

The MODIFY TABLE command can end unsuccessfully if the table being loaded is partially or entirely contained in new extents (data spaces where information is stored) within VTAMLIB. Because VTAMLIB is opened once during VTAM initialization, the table is not accessible until VTAM is halted, restarted, and VTAMLIB is opened again.

The MODIFY TABLE command performs several functions, depending on the values you specify on the OPTION and TYPE operands.

F TABLE,OPT=ASSOC
Using this command, you can change all references to old_table_name to see new_table_name for resource name and its subordinate nodes. If necessary, new_table_name is loaded. Values for old_table_name include:
- Logmode table (TYPE=MODETAB)
- USS table (TYPE=USSTAB)
- Interpret table (TYPE=LOGTAB)
- Associated LU table (TYPE=ASLTAB)
- Message-flooding prevention table (TYPE=FLDTAB)
- Model name table (TYPE=MDLTAB)
F TABLE,OPT=ASSOC,TYPE=COS
Using this command, you can associate a new Class of Service table with the network netid for the gateway NCP or PU type 5 identified by name.
F TABLE,OPT=DEL
Using this command, you can delete the association between name, its subordinate nodes, and old_table_name. If applicable, default tables are used with subsequent session initiation requests.
F TABLE,OPT=DEL,TYPE=COS
Using this command, you can terminate the association between a COS table and network netid for gateway NCP name. A COS table is no longer defined for the specified network.
F TABLE,OPT=DEL,TYPE=FILTER
Using this command, you can delete the current session awareness (SAW) data filter. When you delete the filter, SAW data and trace data for all sessions are sent over the CNM interface.
F TABLE,OPT=LOAD
Using this command, you can replace old_table_name, which is in use, with new_table_name, which is currently not in use, or to reload a table that is in use. All resources currently associated with the old table are reassociated with the new table.

Note: If old_table_name is the current value of the DYNMODTB start option, the value of the DYNMODTB start option is changed to new_table_name.

If OLDTAB is omitted, it is assumed to be the same as NEWTAB.
F TABLE,OPT=LOAD,TYPE=FILTER
Using this command, you can replace the current session awareness data filter, which is in use, with a new filter, which is currently not in use, or to reload a filter that is in use.
F TABLE,OPT=LOAD,TYPE=CMIPDDF
Loads the current version of the CMIP services directory definition file, which lists the systems that are and are not allowed access to CMIP services.

When CMIP services is started, CMIP services reads in the directory definition file. You can update the directory definition file while VTAM is running, but CMIP services is aware of these changes only when the MODIFY TABLE command is issued.

Note: If you use the MODIFY TABLE command to change or delete a table association, be aware that later use of a VARY ACT,UPDATE=ALL command for dynamic reconfiguration can undo the effects of the MODIFY TABLE command. This is because the table name in the definition file overrides the value that was changed or deleted with the MODIFY TABLE command. Even if no table name is coded in the definition file, VTAM assumes a null value for the table name and the null value overrides the MODIFY TABLE value. To prevent the new table name specification from being overridden unintentionally, code the definition statement with the required value.

Operands

procname

The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM start procedure and ident is the optional identifier, either startname.ident or ident can be specified for procname.

If procname in the START command was startname, startname must be specified for procname.

ID=name

Identifies the resource. All resources at or below this resource in the hierarchy are considered eligible resources.

The name can be a network-qualified name. If the name specified on the ID operand is network-qualified, this name is considered to be the real name of the resource. If a cross-network CDRSC is to be specified on the ID operand, it must be specified as a network-qualified name if the CDRSC is defined using NQNMODE=NQNAME (either by definition or start option). For a message-flooding prevention table (TYPE=FLDTAB), this value must always be specified as ISTNOP.

Tip: If you are specifying a model resource (APPL or CDRSC), you can use wildcard characters in the name you specify. The use of wildcard characters on the ID operand does not depend on the value of the DSPLYWLD start option.

NETID=netid

Identifies the network attached to a gateway NCP with which the Class of Service table association is to be changed.

Note: If a model network is defined by using COPIES as part of the network definition, then *NETWORK is used to change the Class of Service table for the model network.

NEWTAB=new_table_name

Identifies the table to be used. When the new table is of TYPE=USSTAB, then FORMAT=DYNAMIC must have been coded on the USSTAB macro for the referenced table.

VTAM validates the table type.

OLDTAB

Specifies a specific old table or all old tables.

OLDTAB=old_table_name

For OPTION=ASSOCIATE, changes associations for the resource specified by the ID operand (and its subordinate resources) and currently associated with the named table.

For OPTION=DELETE, terminates associations for the resource specified by the ID operand (and its subordinate resources) and currently associated with the named table.

For OPTION=LOAD, replaces the old table with the table identified by the NEWTAB operand. Resources associated with the old table are reassociated with the new table.

Note: If old_table_name is the current value of the DYNMODTB start option, the value of the DYNMODTB start option is changed to new_table_name.

OLDTAB=*

For OPTION=ASSOCIATE, indicates that the specified table associations should be changed to new_table_name, regardless of the current table associations.

For OPTION=DELETE, changes the associations of all eligible resources specified by the ID operand regardless of any current table associations.

OPTION

Specifies whether a table is to have its resource associations changed or deleted, or whether the table is to be loaded.

OPTION=ASSOCIATE

Specifies the table is to have its resource associations changed or load the new table and associate it with a resource. It changes the associations of the specified resources. If the table to be associated is not in use, VTAM loads it. Current table associations for a specific resource can be determined by issuing one of the following commands:

The DISPLAY COS command for the resource named on the ID operand
The DISPLAY ID command for the resource named on the ID operand or its subordinate nodes

If the MODETAB, LOGTAB, or USSTAB value is omitted from the original resource definition, the default table can be used. However, the name of the default table is not stored with the resource definition. Therefore, MODIFY TABLE,OLDTAB=default_name, NEWTAB=new_table_name does not change the table association; however, OLDTAB=*,NEWTAB=new_table_name does provide that function.

If COSTAB was not specified on either the BUILD or NETWORK definition statement, OPTION=ASSOCIATE adds the appropriate Class of Service specification.

A non-gateway SSCP (GWSSCP=NO) can associate a Class of Service table only for the native network of a gateway NCP.

Specifying MODIFY TABLE,OPTION=ASSOC,TYPE=COS, ORIGIN= host_pu_name, NEWTAB=ISTSDCOS,NETID=host_netid requests that VTAM attempt to load ISTSDCOS if it is not currently loaded. This enables the user to create and load a copy of ISTSDCOS, even though one might not have been available during VTAM initialization. host_pu_name can be either ISTPUS or the name specified in the HOSTPU start option.

Use MODIFY TABLE,OPTION=LOAD,NEWTAB=ISTSDCOS to request VTAM to reload ISTSDCOS if it is currently loaded.

OPTION=DELETE

Specifies the table is to have its resource associations deleted. It terminates the association between the specific resources and the table.

If USSTAB, MODETAB, LOGTAB, ASLTAB, or MDLTAB is not specified when the resource is defined, there is no association to terminate. Where applicable, the default table is still used.

If old_table_name is an IBM®-supplied default table (for example OLDTAB=ISTINCDT or OLDTAB=ISTSDCOS), all explicit table associations are terminated, but the table is not deleted from memory. If old_table_name is not an IBM-supplied default table, it is deleted from memory as a result of this command.

OPTION=LOAD

Specifies the table is to be loaded to replace an existing table.

When OPTION=LOAD,NEWTAB=new_table_name is specified:

The MODIFY TABLE command loads the table named in the NEWTAB operand. All resources associated with the old table are reassociated with the new table. If the OLDTAB and NEWTAB operand values are identical or OLDTAB is omitted, the indicated table is reloaded into memory.

Note: All tables must be associated with resources. OPTION=LOAD replaces a table only if it is already being used by a resource. OPTION=ASSOCIATE can be used to load a new table (which is not in use) and associate it with a resource.

The IBM-supplied tables can be reloaded (old_table_name is equal to new_table_name), but cannot be deleted (old_table_name is not equal to new_table_name).

When OPTION=LOAD,TYPE=CMIPDDF is specified:

CMIP services reads in the current version of the directory definition file without disrupting the CMIP application programming interface or any topology manager or topology agent application programs. If the MODIFY command fails, the existing directory definition file remains in use.

If CMIP services is not active when the command is issued, a message indicates that it is not active. When CMIP services becomes active, it reads in the current version of the directory definition file.

If CMIP services is active when the command is issued, it reads in the current version of the directory definition file from SYS1.SISTCMIP. The directory definition file indicates the instances of CMIP services that can have associations with one another. For a description of associations, see z/OS Communications Server: SNA Network Implementation Guide. Existing associations are not affected by this command. For example, if the directory definition file denies access to an application program that already has an association with CMIP services, the association remains established. However, if this association ends, it cannot be reestablished, because the directory definition file denies access to that application program.

ORIGIN=ncp_name

Identifies the NCP major node of a gateway NCP for which the Class of Service table association is to be changed.

TYPE

Specifies the type of table the command will process. This type must be one of the following values:

TYPE=ASLTAB: Specifies the associated LU table.
TYPE=CMIPDDF: Specifies the updated CMIP services directory definition file.
TYPE=COSTAB: Specifies the Class of Service table.
TYPE=FILTER: Specifies the session awareness data filter.
TYPE=FLDTAB: Specifies the message-flooding prevention table. For TYPE=FLDTAB, ID must be specified as ISTNOP.
TYPE=LOGTAB: Specifies the interpret table.
TYPE=MDLTAB: Specifies the model name table.
TYPE=MODETAB: Specifies the logon mode table.
Note: The MODIFY TABLE command does not change the value of the DLOGMOD operand. To change the value of the DLOGMOD operand, see the MODIFY DEFAULTS command or the MODIFY RESOURCE command.
TYPE=USSTAB: Specifies the USS table. If message IST116I is received because the USSTAB start option is incorrect, MODIFY TABLE,OPTION=ASSOCIATE,ID=ISTNOP,OLDTAB=*, NEWTAB=new_table_name can be issued to supply a new USS table, represented by ISTNOP, for the network operator.
When OPTION=ASSOCIATE or OPTION=DELETE is specified, VTAM does not change the value of USS LANGTAB tables. When OPTION=LOAD is specified, VTAM changes the USS LANGTAB table if old_table_name or new_table_name is currently being used as a LANGTAB table. For more information about LANGTAB processing using USS commands, see the z/OS Communications Server: SNA Resource Definition Reference.

Examples

Load a new USS table and associate it with a resource:

F VTAM,TABLE,TYPE=USSTAB,OPTION=ASSOCIATE,NEWTAB=USSTAB1,ID=LU1,OLDTAB=*

Change another LU's USS table definition to the table loaded by the previous example:

F VTAM,TABLE,TYPE=USSTAB,OPTION=ASSOCIATE,NEWTAB=USSTAB1,ID=LU2,OLDTAB=*

Change all resources using an existing USS table to use a new USS table:

F VTAM,TABLE,OPTION=LOAD,NEWTAB=USSTAB2,OLDTAB=USSTAB1

Change all resources using an existing USS table to use an updated copy of the USS table:

F VTAM,TABLE,OPTION=LOAD,NEWTAB=USSTAB2