PSCREEN PUT

Authorization

General User

Purpose

Use the PSCREEN PUT command to copy the image of a physical screen to a CMS file.

Operands

fn

is the file name of the file into which the image is copied.

ft

is the file type of the file into which the image is copied.

fm

is the file mode letter of the file. The default is *, which is the first read/write disk or directory in the search order containing the specified file.

Usage Notes

1. The PSCREEN PUT command copies the last physical screen image that was displayed in a window.
2. If the file does not exist, it is created on the first disk or directory accessed R/W (generally this is A). If the file already exists, the data is appended to the end of the file.
3. For a file in fixed format, each line of the physical screen longer than the logical record length of the file is truncated. Lines that are shorter than the logical record length are padded with blanks.

Messages and Return Codes

• DMS037E Filemode mode is accessed as read/only [RC=12]
• DMS048E Invalid filemode mode [RC=24]
• DMS062E Invalid character char in fileid [fn ft [fm]] [RC=20]
• DMS069E Filemode mode not accessed [RC=36]
• DMS105S Error nn writing file fn ft fm on disk or directory [RC=100]
• DMS107S Disk mode(vdev) is full [RC=100]
• DMS386E Missing operand(s) [RC=24]
• DMS388E Invalid keyword: keyword [RC=24]
• DMS391E Unexpected operand(s): operand [RC=24]
• DMS531E Disk or file space is full; set new filemode or clear some disk space [RC=13]
• DMS917E No windows are displayed [RC=4]
• DMS924E Data was truncated [RC=3]
• DMS1144E Implicit rollback occurred for work unit workunitid [RC=31]
• DMS1252T Rollback unsuccessful for file pool filepoolid
• DMS1258E You are not authorized to write to file fn ft fm│dirid [RC=28]
• DMS1262S Error nn opening file fn ft fm [RC=100]

Additional system messages may be issued by this command. The reasons for these messages and their location are: