Sub programa de señalización ambiental

This command is used to define a record in a Tandem BIND table. Each record represents a BIND image.

ADD LOGMODENT bind-entry-name , TYPE type-value , FMPROF fm-profile-value , TSPROF ts-profile-value , PRIPROT priprot-value , SECPROT secprot-value , COMPROT comprot-value , SSNDPAC ssndpac-value , SRCVPAC srcvpac-value , PSNDPAC psndpac-value , PSERVIC pservic-value , ENCR encryption-value , PLUNAME plu-name , USERDATA user-data bind-entry-name

specifies the name of a record from within the BIND table. The value for bind- entry-name can be from one to eight alphanumeric and special characters. Note that LUNS uses the value specified for bind-entry-name as the key to a particular BIND image. Therefore, you should also specify this value as either of the following:

Part of the BINDENTRY attribute when using an SCF ADD LINE, ADD PU, or ADD LU command

The BINDENTRY attribute in an ESS record

TYPE type-value

specifies the type of BIND command represented by this BIND image. Any hexadecimal values between %H00 and %H0F can be specified for type-value; however, only 0 and 1 are currently defined, where:

%H00 = a negotiable BIND.

%H01 = a non-negotiable BIND. (This is the default.)

FMPROF fm-profile-value

specifies the function management profile (byte 2 of the BIND image). Any hexadecimal number in the range of %H00 to %HFF can be specified for fm- profile-value.

SNAXUTL ADD Commands

TSPROF ts-profile-value

specifies the transmission services profile (byte 3 of the BIND image). Any hexadecimal number in the range of %H00 to %HFF can be specified for ts- profile-value.

The default value is %H03.

PRIPROT priprot-value

specifies the primary LU protocol (byte 4 of the BIND image). Any hexadecimal number in the range of %H00 to %HFF can be specified for priprot-value. The default value is %HB1.

SECPROT secprot-value

specifies the secondary LU protocol (byte 5 of the BIND image). Any hexadecimal number in the range of %H00 to %HFF can be specified for secprot-value. The default value is %H90.

COMPROT comprot-value

specifies the common LU protocols (bytes 6 and 7 of the BIND image). Any hexadecimal number in the range of %H0000 to %HFFFF can be specified for

comprot-value.

Note that the required value for 6530 devices is %H7080. The default value is %H3080.

SSNDPAC ssndpac-value

specifies the secondary receive pacing count (byte 8 of the BIND image). Any hexadecimal number in the range of %H00 to %H3F can be specified for

ssndpac-value.

The default value is %H00.

Note that SNAX/XF does not support pacing. Therefore, any value specified other than the default of %H00 will be treated by SNAX/XF as if the default of %H00 was specified.

SRCVPAC srcvpac-value

specifies the secondary send pacing count (byte 9 of the BIND image). Any hexadecimal number in the range of %H00 to %H3F can be specified for

srcvpac-value.

The default value is %H00.

Note that SNAX/XF does not support pacing. Therefore, any value specified other than the default of %H00 will be treated by SNAX/XF as if the default of

SNAXUTL ADD Commands

PSNDPAC psndpac-value

specifies the secondary send pacing count (byte 12 of the BIND image). Any hexadecimal number in the range of %H00 to %H3F can be specified for

psndpac-value. Primary receive pacing count (byte 13 of the BIND image) is also set to the value set for PSNDPAC.

The default value is %H00.

Note that SNAX/XF does not support pacing. Therefore, any value specified other than the default of %H00 will be treated by SNAX/XF as if the default of %H00 was specified.

PSERVIC pservic-value

specifies the logical unit presentation services profile and usage field (bytes 14 through 25 of the BIND image). The default values for pservic-value are found in Appendix F of this manual. Note that if this command object is not specified, SNAX/XF will generate values for PSERVIC and place them in the BIND image at run time.

The values for this command object are entered by first specifying %H, followed by from one to twelve bytes of information. The following example shows all twelve bytes filled:

PSERVIC %H010203040506070809AABBCC

If less than twelve bytes of information are entered, as in:

PSERVIC %H02030405

the field in the BIND image will be right-justified with zeros.

ENCR encryption-value

specifies the type of cryptography that is expected by the LU (byte 26 of the BIND image). Any hexadecimal number in the range of %H00 to %H0F can be specified for encryption-value.

The default value is %H00.

PLUNAME plu-name

if present, plu-name begins at byte 28 of the BIND image. It is specified as a string value and is a maximum of eight bytes long, enclosed in quotes:

PLUNAME "CREDIT" PLUNAME "DEPART03"

The length of plu-name is found specified at byte 27 (if this command object is not specified, the value found will be %H00).

SNAXUTL ADD Commands

USERDATA user-data

If a value for plu-name is not present, the length specified for user-data will be found at byte 28, and the user-data value(s) will begin at byte 29.

If a value for plu-name has been specified, then the length for user-data will be found at the next byte past plu-name, and the user-data value(s) will follow. If a value for plu-name has been specified, and USERDATA user-data is not specified, then the USERDATA length byte will be %H00.

If neither PLUNAME or USERDATA is specified, then the user-data length byte is not included in the BIND image. In this case, the last byte in the BIND image will be byte 27 (the length of plu-name, which is %H00).

The value for user-data is specified as a hexadecimal string enclosed in

parenthesis, with a maximum length of 221 bytes. See the following examples:

USERDATA (%H40,%H54,%H41,%H4E,%H44,%H45,%H4D,%H40) USERDATA (%HC1,%HC1,"AAAAAA", "BBBB", %HC2, %HC3)

Note that the total length of the BIND image cannot exceed 256 bytes, including what is specified for plu-name and the command object that follows it, user- data.

Example: Constructing a Bind Image

The following is an example BIND image as constructed using LOGMODENT. It resides in $vol.subvol.file.

BEGIN

SELECTFILE LOGTAB1, TYPE LOGMODE ALLOCATE 10

ADD LOGMODENT bind1, TYPE %H01, & FMPROF %H03, & TSPROF %H03, & PRIPROT %B01, & SECPROT %H90, & COMPROT %H3080, & PSERVIC %H020000000000185018507F00, & PSNDPAC %H00, & SRCVPAC %H00, & SSNDPAC %H00, & PLUNAME "APPL1", & USERDATA (%HC1,%HC3,"DEPT 103" ) END

SNAXUTL ADD Commands

For example, run SNAXUTL using the following command:

RUN SNAXUTL /IN $vol.subvol.file/

A source file named LOGTAB1 and an object file named LOGTAB1O will be allocated. Based on the above example, SNAXUTL builds the BIND image and places it in both files as a record named bind1. SNAX/XF retrieves the BIND image after reading the object file (LOGTAB1O) into extended memory.

ADD SETESS Command The ADD SETESS command adds to the SET table a record representing an ESS table.

ADD SETESS ess-table-name , FILENAME filename

[ , DEFAULTTABLE { Y | N } ] ess-table-name

is the table name of the ESS table. The value specified for ess-table-name can contain from one to eight alphanumeric and special characters.

Note that unless you are designating this table as the default table, you specify the same table name as part of the ESSTABLE attribute when you use the SCF ADD command to add a LINE PU, or LU object.

FILENAME filename

is the name of the table source file in which the ESS table can be found. If you are running SNAXUTL on a volume and subvolume different from the ones on which the table source file resides, the value specified for filename must be fully qualified. The filename is the same as the one which was used in the SELECTFILE-TYPE ESS command.

DEFAULTTABLE { Y | N }

specifies whether or not the ESS table being defined is to be the default ESS table. If this operand is not specified, the default value is N.

SNAXUTL ALLOCATE Command

ADD SETLOG Command This command is used to add to the SET table a record representing a BIND table.

ADD SETLOG bind-table-name , FILENAME filename bind-table-name

is the table name of the BIND table. The value specified for bind-table-name

can contain from one to eight alphanumeric and special characters.

FILENAME filename

is the name of the table source file in which the BIND table can be found. If you are running SNAXUTL on a volume and subvolume different from those on which the table source file resides, the value specified for filename must be fully qualified. This is the same file that was created using the SELECTFILE TYPE LOGMODE command.

The following is an example of how to add a BIND table and table source file name to the SET table:

BEGIN

SELECTFILE snxset, TYPE SET

ADD SETLOG BINDTAB1, FILENAME $DATA.TABLES.LOGTAB1 END

BINTAB1 is the name of the source BIND table $DATA.TABLES.LOGTAB1.

SNAXUTL ALLOCATE