VSAMSTART: Start passing AMS commands to VSAM

Use the VSAMSTART command to tell CICS® VR to start passing AMS commands to VSAM after a VSAM sphere has been recovered.

The VSAMSTART command has no synonyms.

Format

Read syntax diagramSkip visual syntax diagram
>>-VSAMSTART--DSN--(--data set name--)-------------------------><

Keywords

DSN(data set name)
Specifies the data set for which recovery must be successfully completed before the AMS commands are passed to VSAM. The DSN keyword is required. You can only specify this keyword once per VSAMSTART command.
data set name
Specifies the data set name, which is 1–44 characters.

Usage notes

Consider the following when using the VSAMSTART command:

  • The DSN keyword must be on the same line as the VSAMSTART command.
  • You can use the VSAMSTART/VSAMEND combination to rebuild AIXs after a successful forward recovery.

Examples

  VSAMSTART  DSN(TEST.PAYROLL.BASE)
    BLDINDEX                           -
       INDATASET(TEST.PAYROLL.BASE)    -
       OUTDATASET(TEST.PAYROLL.PATH)
  VSAMEND    DSN(TEST.PAYROLL.BASE)

This pair of VSAMSTART and VSAMEND commands tells CICS VR to pass the AMS BLDINDEX command to VSAM when the recovery of TEST.PAYROLL.BASE has successfully completed. The AIX® for TEST.PAYROLL.BASE is built by VSAM when CICS VR has recovered TEST.PAYROLL.BASE.

For details of the VSAMEND command, see VSAMEND: Stop passing AMS commands to VSAM.