Remote System Information › z/VSE › Format for SAM File Names

Format for SAM File Names

Use the following format to name a SAM file:

file-id,S,[unit],[location],[size],[override]

The following list describes the parts of a SAM file name:

file-id

The name that identifies this data set in the VTOC of the specific DASD volume. This is the file ID you specify on the DLBL JCL statement. Range: 1 to 44 characters.

Note: Do not enclose it in quotes.

S

Indicates that this is a SAM file.

unit

The physical device address as defined by the CUU parameter on the ASSGN JCL statement. It identifies the disk drive on which this file resides. This parameter can be omitted if the UNIT or VOL parameters are specified, or if a DASD manager is in use.

location

Optional for output files.

The starting location of the file on the disk, as defined on the EXTENT JCL statement. If a DASD manager is in use, specify a value of 1.

size

Optional for output files.

Indicates how much space this data set is to use, as defined on the EXTENT JCL statement. For CKD devices, this is the number of tracks. For FBA devices, this is the number of blocks.

override

Optional for output files.

The following override parameters can be specified. The equivalent DFLTAB option is included to describe each override parameter:

• DMYES to force DASDM=YES for this file
• DMNO to force DASDM=NO for this file
• DMEPIC to force DASDM=EPIC for this file

Note: If you are running with a DASD manager, the DASD manager's STRTTRK or Trigger value would be placed in the location field. DASD manager pools should be indicated by putting the pool name in the Volume parameter.

For EPIC/VSE users, you can omit the following:

• The location if you want EPIC to default to its STRTTRK value.
• The size if you want EPIC to default to its DEFEXT value.
• The Volume information if you want EPIC to default to its DEFPOL value.

For CA Dynam/T users who want to access Dynam catalog controlled files (included GDG data sets), no extent information should be entered. (No cuu, location, size, or override information and no Volume or Unit parameters for the files you are referencing.)