The order of the records in a permanent work file depends on the order DSAP reports your request.
Initially, the records are ordered in the standard collating sequence by their names. The by-user
and DETAIL reports sort the records by owner ID and then by file name. The format for the records
in the permanent file is provided in a DDL description released with the program.
If the WORKFILE option is specified and the work file does not exist, DSAP creates the file and
allocates as many extents as needed based on the amount of free space on the volume. It is best
to specify a nonexistent work file, because the file created is automatically the appropriate size.
The extent sizes depend on the capacity of the work file volume.
Although the preferred method is to let DSAP create the work file, you can specify an existing work
file, but the DSAP process terminates if the file is not large enough. You can also create a new
work file before you run DSAP. The result is the required work file size in bytes:
(Number of v 1) *
Average number of files in each volume *
Byte length of the directory record =
Required workfile size in bytes
The byte length of the directory record is defined in DSAPDDL.
When you use the WORKFILE option to create a multiple-volume report, the work file contains file
records for all of the selected volumes grouped by volume name. The volume name appears as
the first eight characters in each file-label record.
If you are the system manager and prefer to use a particular disk for large temporary files, you
can specify that volume as the default by modifying DSAP with Binder, as described in
Changing
the Default Work File Volume (page 111)
.
If you do not specify a WORKFILE option, the work file from DSAP is allocated by default on the
volume where the program swap file resides. To alter this default permanently, use Binder.
Any errors that occur when DSAP creates or allocates the work file space are reported in the output
file and cause DSAP to terminate.
Always use the current DSAPDDL to analyze the work file. For more information on DDL, see the
Data Definition Language (DDL) Reference Manual.
NOTE:
If the SMF files are on virtual volumes, the external name field contains the virtual name
of the file, and the physical field contains the physical name of the file.
Changing the Default Work File Volume
DSAP lets you alter the default work file volume specification using the BINDER program. The
following example illustrates the brief BINDER session that is required to accomplish the change.
In the object files of DSAP and DCOM, the default work file volume name is located at the beginning
of the procedure SELECT^WORK^VOLUME.
In this example, the volume name for the work file from DSAP is set to $TEMP. The characters for
the volume name must be specified as a character pair in quotation marks. $TEMP is specified
"$T", "EM", "P), “ ” (for a total of eight characters).
1> VOLUME $SYSTEM.SYSTEM
2> BIND
@FILE DSAP
@ADD *
@MODIFY CODE SELECT^WORK^VOLUME ASCII 0,"$T","EM","P "," "
@BUILD DSAP!
@EXIT3> FUP LICENSE DSAP
The FUP LICENSE command is optional. This command depends on the type of file security you
need. You must relicense the program because the BINDER BUILD command removes the old
license. For information on the FUP LICENSE command, see the File Utility Program (FUP) Reference
Manual. For information on the BINDER program, see the Binder Manual.
Format of the Permanent Work File
111
