Display Contents of SAM/PAM Files opened in Output Mode

D If open files have been selected with the User Option OPEN [S] (see page A1-), the D Action Code can be used to display the contents of SAM or PAM files (e.g. SYSOUT / SYSLST files, CONSLOG files).

Notes:

The D Action Code works by transferring the current contents of the open file to a temporary file, which is then displayed by CFS. D thus provides an easy way of updating this temporary file. The command sequence D;++ will position the display at the end of the SAM file.

Usually, the contents of an ISAM file opened in write mode cannot be displayed, or only if it is opened as SHARUPD=YES. A special option can nevertheless be used to display the contents of an ISAM file in PAM format. This is done by executing the following CFS command once before issuing the D Action Code: M L'29AD','X'

For SAM/PAM files opened in Output mode, the value in the LASTP column of the file list will contain the number of occupied PAM pages at the time the selection took place.

When using the D Action Code on a file with a LASTP value greater than 200, the transfer of the PAM blocks already created to the temporary file can take some time. The user will therefore be asked if the display is to be of the entire file, or only of the last n PAM blocks. Choosing a small value for n will ensure a negligible delay in transferring the PAM blocks to the temporary file.

The D Action Code can also be used by non-privileged users to diplay the contents of open SAM/PAM files. In order to use this option, the system administrator must have started a CFS-Holder task from under TSOS: /ENTER $CFS.CFS.S.LMSLIB(CFSHT). For further information, see the inline description within this Enter file.