Previous Topic: TSSRECVRNext Topic: Examples


TSSCRIPT

TSSCRIPT executes a series of TSS commands (a “command script”) in batch mode and returns the output produced by these commands to the job submitter. VM users may realize that a CMS EXEC can be used to execute multiple CP TSS commands automatically; however, doing so might tie up the user’s virtual machine for a significant period of time. Moreover, the only way to capture the output from these commands is to spool the virtual console before invoking the EXEC, resulting in a poorly formatted record of command activity.

The purpose of TSSCRIPT is to provide CA Top Secret users with a method of executing TSS commands. TSSCRIPT is executed in a CA Top Secret batch job. The TSS command script is provided to the program as SYSIN data; EXEC keywords are not supported and are ignored.

Each TSS command must begin with the characters “TSS” in the command script. This may be preceded by one or more blanks, and at least one blank must separate it from the remainder of the command. A record consisting of the characters “TSS” alone is invalid.

Since TSS commands may be longer than an eighty-character punched statement, command continuation is supported. A command may be continued by placing a hyphen ('-') in the last non-blank position in the record. All characters, including blanks, up to but not including the hyphen itself are included in the input to the TSS command processor, and the command is continued starting at the first non-blank character in the following record. If continuation is indicated but no continuation record is found (that is, end-of-file is encountered, the next record is blank or begins begins with “TSS”), an error message is generated, the command is NOT executed, and TSSCRIPT terminates immediately

A command may be continued over several input records however; the total length of the resultant command must not exceed 1270 bytes. By default the TSS command can be entered in any case and will be upper case before it is executed. In some cases, Linux for example, the data is allowed to be in mixed case. In order to support the ability to use mixed case data, TSSCRIPT has two control cards that must being in column 1 and be the only information on the record.

CASE UPPER

All records following this card should be upper case prior to use until the next control card.

CASE MIXED

All records following this card should remain in the entered case until the next control card.

The default is CASE UPPER.

Note: All TSS keywords must be in upper case when entered.