Batch Operations › Available Batch Utility Programs › TSSCRIPT › Examples

Examples

Examples of commands submitted using TSSCRIPT:

TSS ADDTO(USER1) -
     LINUXNAM(Some.Linux.Name)

Will get added to USER1 as LINUXNAME(SOME.LINUX.NAME:

TSS ADDTO(USER1) -
CASE MIXED
     LINUXNAM(Some.Linux.Name)

Will get added to USER1 as LINUXNAM(Some.Linux.Name)

TSS ADDTO(USER1)-
CASE MIXED
     linuxnam(Some.Linux.Name)

Will get “TSS05501 Unknown Keyword – linuxnam” because the keyword linuxnam must be entered in upper case.

TSS ADDTO(USER1)-
   linuxnam(-
CASE MIXED
“Some.Linux.Name”-
)

Will get added to USER1 as LINUXNAM(Some.Linux.Name) because the keyword “linuxnam” is before the CASE MIXED and therefore automatically uppercased by the system. Care must be used to not have blank characters in the data portion of the field.

Comments are supported in the input TSS command script. A comment region is defined as one or more input records or portions of input records delimited by the comment initiator and comment terminator strings. The comment initiator is a slash followed by an asterisk (/*) and the comment terminator is the inverse, an asterisk followed by a slash (*/). A comment region may begin and end at any character position of any record of the command script, and may span multiple input records. A comment region essentially is treated as a zero-length field by TSSCRIPT; that is, all characters within and including the comment delimiters are logically omitted from the input record before its use in TSS command construction.

However, each line is still treated as a separate input entity. If a comment is wholly contained in one input record, all characters immediately following the comment terminator are logically concatenated to the characters immediately preceding the comment initiator. In the case of a multiple-record comment, the text preceding the comment initiator on the first record is treated by command construction as one line; text following the comment terminator on the last record of the comment region is also treated as a separate line; any intervening input records are ignored.

Note that all comment removal is done prior to line continuation and command construction, and line continuation is not assumed for multiple-record comments. You must be sure that any required continuation characters fall outside the comment region subsequent to comment removal. For your convenience in debugging and interpreting the results of command script execution, message TSS0540I displays the intermediate text of script input records used as input to TSS command construction after comments have been removed. Nested comments are not supported.

The following example job file illustrates CA Top Secret batch TSS command script execution:

//TSSJOB ACID=SECADMIN,PASSWORD=ILUVTSS
//EXEC   PGM=TSSCRIPT
TSS Create(USER2) Type(user) - /* This is a comment */
        Name('John Q. User') -
        Password(educated)   - /* Temp Password */
        Dept(Payroll)
/*TSS Create(USER3) Type(user) - This entire...
        Name('Jane M. Doe')    - command has been...
        Password(FAWN)         - commented out.
        Dept(Woodland)
*/
  TSS Add(USER2) Profile(PayProf1)
  TSS List(Acids) Dept(Payroll) Data(Profile-
      ,XAUTH)