Keywords › INTO Keyword—Store TSS Commands to a PDS Data set

INTO Keyword—Store TSS Commands to a PDS Data set

Use the INTO keyword on a LIST with ARCHIVE keyword or a MODEL command to write the specified user’s security record into a PDS data set in the form of TSS commands. The produced TSS commands can be used to recreate the user in the future.

Use the ARCHIVE keyword for the DELETE command to archive the user prior to deletion. If ARCHIVE is specified on the DELETE command the INTO keyword is mandatory.

For LIST and DELETE commands, if the INTO keyword is specified the ARCHIVE keyword is also required.

For the INTO keyword:

• The dataset must be a PDS dataset with LRECL=80.
• If the PDS data set specified on the INTO keyword is under TSS protection, the user executing the command must have permission to the data set. If user not authorized:
  • When running in FAIL mode, an error message is displayed and the command is failed
  • When running WARN mode, an error message is issued and the command runs to completion.
• If the PDS dataset specified on the INTO keyword exists, that dataset will be overwritten.
• If the member specified on the INTO keyword already exists, that member will be overwritten.
• If the PDS data set specified on the INTO keyword does not exist, a PDS data set will be created with DCB info (FORMAT=FB, LRECL=80, BLKSIZE= 27920, DSORG=PO, TRKS=14, DIR=5). This new new PDS data set is created on a common storage volume that is defined in the VATLSTnn member of SYS1.PARMLIB.

The first record in theTSS command output is a comment record that identifies the command, the user(s) involved, the date and time of command execution, which TSS administrator issued the command, and what system the command was executed on:

/*ARCHIVE  CASSIE   STORED 02/17/10-09.54.00 BY MASTER1  ON XE15
/*MODEL  NEWCAS   STORED 02/18/10-14.41.53 BY MASTER1  ON XE15 USING CASSIE

This keyword has the following format:

TSS LIST(acid) ARCHIVE INTO(datasetname(membername)) 
TSS DELETE(acid) ARCHIVE INTO(datasetname(membername)) 
TSS MODEL USING(acid) ACID(newacid) INTO(datasetname(membername))

INTO(datasetname(membername))

(Optional) Identifies the name and optionally a member name of a PDS data set where commands will be stored. If this keyword is not used for MODEL and LIST commands, TSS commands will be displayed.

datasetname

Specifies the data set where commands will be stored.

Limits: PDS dataset with LRECL=80.

membername

(Optional) Specifies the member name of the data set where commands will be stored.

Default: Value specified in the ACID keyword.

This keyword is used with:

• The commands LIST, DELETE, and MODEL
• The ACID types User, DCA, VCA, ZCA, LSCA, and SCA
• ACID(MAINTAIN) authority DATA(ALL)

Examples: INTO keyword

Examples using ARCHIVE:

• This example generates the archive command output in a user-specified member in a PDS dataset called KOTPA01.RACHAEL.ARCHIVE with member name Rachaelk:

  TSS LIST(Rachael) ARCHIVE INTO(kotpa01.rachael.archive(Rachaelk))
  

• This example generates the archive command output in a user specified member in a PDS dataset called KOTPA01.RACHAEL.ARCHIVE without member name. The member will be set to the acid name specified by the LIST keyword:

  TSS LIST(Rachael) ARCHIVE INTO(kotpa01.rachael.archive)
  

• This example deletes the user Rachael, and generates the archive command output in a user specified member in PDS dataset called KOTPA01.RACHAEL.ARCHIVE without member name:

  TSS DELETE(Rachael) ARCHIVE INTO(kotpa01.rachael.archive)
  

• This example deletes the user Rachael, and generates the archive command output in a user specified member in PDS dataset called KOTPA01.RACHAEL.ARCHIVE with member name Rachaelk:

  TSS DELETE(Rachael) ARCHIVE INTO(kotpa01.rachael.archive(Rachaelk))
  

Examples using MODEL:

• This example generates the model command output for new acid NewRac using the existing acid Rachael in a user specified member in a PDS data set called KOTPA01.RACHAEL.MODEL with the member name Rachaelk:

  TSS MODEL USING(Rachael) ACID(NewRac) INTO(kotpa01.rachael.model(Rachaelk))
  

• This example generates the model command output for new acid NewRac using the existing acid Rachel in PDS data set called KOTPA01.RACHAEL.MODEL without a member name. The member name will be set to the acid name specified in ACID keyword:

  TSS MODEL USING(Rachael) ACID(NewRac) INTO(kotpa01.rachael.model)