XEDIT

Read syntax diagramSkip visual syntax diagram Xedit1 fnft*fmpathname (2(3OptionsUpdate Mode Options)
Options
Read syntax diagramSkip visual syntax diagramWINdowXEDITWINdowwnameWidthwidth NOSCreen PROFilePROFILEPROFilemacronameNOPROFil NOCLear NOMsg MEMbermembernameLOCkNOLOCkNOUpdateUpdateBFSLineNLBFSLinelreclCRLFCRNL/ string// hexstring/NAMetypeCMSNAMetypeBFS
Update Mode Options
Read syntax diagramSkip visual syntax diagramSeq8NOSeq8Ctlfn1NOCtl Merge UNtilft1Incr1IncrincrSIDcodestring
Notes:
  • 1 If a profile is invoked which issues a LOAD subcommand that specifies fn and ft or pathname, fn and ft or pathname are not required.
  • 2 The default options are shown above the main line in the options groups.
  • 3 You can enter options in any order between the parentheses. If a default is not shown for an option, refer to the option description for the information.

Purpose

Use the CMS command XEDIT to invoke the editor to create, modify, and manipulate CMS files on disk, SFS files, or BFS regular files in the byte file system. Once you invoke the editor, you can execute XEDIT subcommands and use REXX or the EXEC 2 macro facility.

You can return control to the CMS environment by entering the XEDIT subcommand FILE, FFILE, QUIT, or QQUIT.

Operands

fn ft
are the file name and the file type of the SFS or minidisk file to be edited. If they are not specified here, they must be provided in the LOAD subcommand as part of the profile.

In the GUI environment, if New file is selected from a CMSDESK application, and Xedit has been selected as your editor preference, the XEDIT file ID input window is displayed for CMS files.

fm
is the file mode of the file to be edited, indicating an accessed minidisk or SFS directory where the file resides. The editor determines the file mode of the edited file as follows:
  • Editing existing files

    When the file mode is specified, that disk or directory and its extensions are searched. If the file mode is not specified or is specified as an asterisk (*), all accessed disks and directories are searched for the specified file.

  • Creating new files

    If the file mode is not specified, the editor assumes a file mode of A1.

pathname
is the name of the BFS file to be edited. See Understanding Byte File System (BFS) Path Name Syntax for a description of the different forms of the BFS path name syntax.

Options

WINdow wname
is the name of the virtual screen and window XEDIT uses to display all files being edited in the ring. By default, XEDIT uses the window and virtual screen named XEDIT. This option is ignored in a GUI environment.
Note: The window name must not contain invalid file name characters. Also, CMS or WM cannot be used as the window name.

For more information on virtual screens and windows, see XEDIT Virtual Screens and Windows.

Width width
defines the amount of virtual storage containing one line of the file. If the value specified is too small, certain file lines may be truncated.

When specified, the width value is limited to eight characters in length. If the width value specified is longer than eight characters, the value is truncated to eight characters.

If not specified here, WIDTH may be defined in the LOAD subcommand as a part of the profile. For SFS and minidisk files, if WIDTH is not specified in either the XEDIT command or the LOAD subcommand, the default is the larger of the following:
  • Logical record length (LRECL) of the file.
  • Default logical record length associated with the file type. See File Type Defaults for a list of these defaults.
For BFS files, if WIDTH is not specified in either the XEDIT command or the LOAD subcommand, the default depends upon the BFSLINE value.
  • For BFSLINE lrecl, the default is lrecl.
  • Otherwise, the default value is 80 or the length of the longest line, whichever is larger.
NOSCreen
forces a 3270 display terminal into line (typewriter) mode. This option is ignored in a GUI environment.
PROFile macroname
If the specified macro exists on one of the accessed minidisks or SFS directories, the editor executes it as the first subcommand. If the specified macro exists and is empty, an error message is displayed.

If the specified macro is not found on an accessed CMS disk or SFS directory, an error message is displayed.

If this option is not specified but a macro with a macro name of PROFILE exists, the editor executes it. If the macro exists and is empty, the macro is ignored.

The profile macro must always have a file type of XEDIT. The profile macro may not reside in the byte file system.

NOPROFil
forces the editor not to execute the default PROFILE macro.
NOCLear
specifies the screen is not cleared when the editor gets control. Instead, the screen is placed in a MORE... (waiting) status. Any messages remain on the screen until the CLEAR key is pressed. This option is useful when the XEDIT command is issued from a macro that displays messages. The option is ignored for the GUI window, it only affects an emulator session.
NOMsg
enters a file with a default of SET MSGMODE OFF.
MEMber membername
is the name of a member in the macro library specified in fn ft fm. If MEMBER is specified, ft must be MACLIB. When the MEMBER option is specified, XEDIT scans the specified MACLIB to find the member. If the member is found, XEDIT reads it into storage. If the member does not exist in that library, a new member is created. The member is displayed with a file ID of membername MEMBER fm.

CMS supports SFS MACLIBs which do not have members; however, CMS does not support empty members. If the MACLIB file is empty, an error message is displayed.

MEMBER is ignored if you attempt to use it when editing a BFS file.

LOCk
causes the editor to lock an existing SFS file to prevent other users from modifying the file while you are editing it, or causes the editor to obtain an advisory lock for an existing BFS file while it is being read into the XEDIT session. Note that a BFS file does not remain locked while in the session, and other users may choose to override an advisory lock.

The LOCK option is ignored for files on minidisks and files that reside in SFS directory control directories and files in NFS-mounted directories.

For files in SFS file control directories, you must have write authority to the file to lock it. If you have only read authority, a warning is displayed and the editing session continues without locking the file. LOCK is the default.

For SFS files, the type of lock XEDIT uses is an update session lock. The file is locked only for the duration of your editing session. Other users can read the file while it is locked, but only you can write to it.

NOLOCk
indicates you do not want the editor to try to lock the file.
For SFS files:
You can use this option to edit a file another user has locked SHARE or UPDATE. If you specify NOLOCK, other users can change the file while you are editing it. NOLOCK is the default for files that reside in SFS directory control directories.

You should only use this option if you are not going to make any changes to the file, or if you will save your changes under a different file identifier. Otherwise, any changes you make will not include modifications other users make to the permanent copy of the file during your editing session.

For BFS files:
The editor does not obtain an advisory lock while reading the file into the XEDIT session.
NOUpdate
specifies the editor is to apply no update statements (even if UPDATE is specified in the LOAD subcommand in the profile).
Update
The editor searches all accessed minidisks and SFS directories for a file with a file name of fn and a file type of UPDATE. If the file exists, the editor applies the update statements before displaying the file to be edited. Each modification the user makes is added to the existing UPDATE file. The original source file is not modified.

If the file does not exist, the editor creates a new UPDATE file with a file mode of A1 to contain modifications the user makes. If the original source file (base file) is empty, an error message is displayed. If an update file is empty, an informational message is displayed. For more information on the XEDIT UPDATE option, see z/VM: CMS Application Development Guide.

UPDATE is ignored if you attempt to use it when editing a BFS file.

BFSLine
Use the BFSLINE option to tell XEDIT how to translate a BFS byte stream into records when reading the file into virtual storage for editing and to set the initial setting of SET BFSLINE.

You can define an end-of-line character or characters for use in interpreting lines in a BFS file if you specify anything other than BFSLINE lrecl. When a file is read into an XEDIT session, everything up to the end-of-line character is interpreted as a line and presented as a ‘record’ in the XEDIT session. The end-of-line character is not displayed while XEDITing the BFS file. When a FILE, PUT, PUTD, or SAVE subcommand is entered for the file when it is being written back to a byte file system, the setting of SET BFSLINE is used to determine the end-of-line character that will be used. If the setting has not been changed from its initial value, the same end-of-line character that existed previously will be used. See the description for SET BFSLINE in SET BFSLINE for more information.

BFSLINE lrecl does not separate the file into records based on an end-of-line character.

The BFSLINE option determines the initial setting used for record format (RECFM). For BFSLINE lrecl, this initial setting is fixed (F). For any other BFSLINE value, it is variable (V). Changing this value while in an XEDIT session will affect the way the file is stored in the byte file system. See the SET RECFM command description in SET RECFM for more information.

If not specified, BFSLINE NL is the default.

NL
indicates the new line character (X'15') should be used to delineate lines when reading or writing a BFS file.
lrecl
indicates the file should be treated as a fixed file, with no interpretation of records based on end-of-line characters. When BFSLINE lrecl is in effect, the file is presented as a fixed record format (RECFM=F) file with a logical record length (LRECL) equal to the lrecl value. No end-of-line characters are removed from or added to the file when it is read from or written back out to the byte file system if BFSLINE lrecl is still in effect.

The last record will be padded with blanks if lrecl is something greater than 1 and the last record does not completely fill the last logical record.

CRLF
indicates the carriage return and line feed characters (X'0D25') should be used to delineate lines when reading or writing a BFS file.
CRNL
indicates the carriage return and new line characters (X'0D15') should be used to delineate lines when reading or writing a BFS file.
/string/
allows the user to specify 1 - 2 characters that are used to delineate lines when reading or writing a BFS file. These characters are translated to uppercase before they are utilized. The slash character (/) may not be one of these characters (in other words, you cannot enter ///).
/hexstring/
specifies a hexadecimal string of 2 or 4 characters that defines the value to be used for BFSLINE. The hexstring must be in the format X'nnnn' or X'nn'. You must not specify any spaces in the string, and there must be 2 or 4 hexadecimal characters in the string.

BFSLINE is not used unless NAMETYPE BFS is in effect.

NAMetype
Use the NAMETYPE option to specify whether the file ID will be interpreted to be in the form used for CMS record files or in the form used for byte file system (BFS) files.
CMS
Indicates file IDs will be interpreted to be CMS record files. They will be interpreted as fn ft fm. This is the default.
BFS
Indicates file IDs will be interpreted as path names (pathname). If you are in a GUI environment and NAMETYPE BFS has been specified, the XEDIT file ID prompt is not displayed. Refer to Understanding Byte File System (BFS) Path Name Syntax for a description of the BFS path name syntax.

The following options are significant only if XEDIT is to be used in update mode, but they are ignored if NAMETYPE BFS is specified:

Seq8
specifies the entire sequence field (the last eight columns of each file line) contains an eight-digit sequence number. The SEQ8 option automatically forces the UPDATE option. SEQ8 is the default value.
NOSeq8
specifies the last eight columns of the file line contain a three-character label field, followed by a five-digit sequence number.

The NOSEQ8 option forces the UPDATE option.

Ctl fn1
specifies fn1 CNTRL is an update control file that controls the application of multiple update files to the file to be edited. If the control file is empty, an error message is displayed. (For more information on the CMS UPDATE command, see z/VM: CMS Commands and Utilities Reference).

This option automatically forces the UPDATE and SEQ8 options.

A maximum of 32 unique AUX file names may be specified in fn1 CNTRL. If an auxiliary control file is empty, an informational message is displayed.

NOCtl
specifies the editor is not to use the control (CTL) file (even if it is specified in the LOAD subcommand in the profile).
Merge
specifies all the updates made through the control file and all the changes made while editing will be written into the file whose name is defined by the latest update level (that is, the most recently applied UPDATE file in a control file). This option forces the UPDATE option.
Note: The update file resulting from the merge may have different sequence numbers than if the updates were applied individually.
UNtil ft1
specifies the file type of the last update to be applied to the file. Changes are applied to the file being edited from all file types in the control file, up to and including the file type specified with the UNTIL option.

With the UNTIL option, you can specify file types of update files listed in the control file or of update files listed in an auxiliary control file. Do not specify AUX file types (AUXxxxxx) with the UNTIL option.

The UNTIL option forces the UPDATE option.

Incr incr
When inserting new lines in an update file, the editor automatically computes the serialization; the INCR option forces a minimum increment between two adjacent lines. If this option is not specified, the minimum increment is 1. This option forces the UPDATE option.
SIDcode string
specifies a string the editor inserts in every line of an update file, whether the update file is being created or is an existing file. The editor inserts the specified string in the first eight columns of the last 17 columns of the file line (lrecl-16 to lrecl-9). For example, if you have a file with fixed, 80-character lines, the editor inserts the string in columns 64 through 71. If the string is fewer than eight characters, it is padded on the right with blanks. Any data in the eight columns is overlaid.

This option forces the UPDATE option.

Usage Notes

  1. To use XEDIT on a file in an SFS directory, the directory must be accessed and you must have authorization to access the file. For a file in an SFS file control directory, you must have either read or write authority. For files in SFS directory control directories, you must have either directory read or directory write authority for the directory in which the file resides. For more information on SFS directories and authorizations, see z/VM: CMS User's Guide.

    To use XEDIT on a BFS file, you must have permission to access the file. Refer to the OPENVM PERMIT command description in z/VM: OpenExtensions Commands Reference or enter HELP OPENVM PERMIT for more information.

  2. When the LOCK option is in effect for an SFS file, it is possible for the lock to be removed during your edit session if one of the following abnormal errors occurs:
    • file pool server failure
    • network or Advanced Program-to-Program Communications/VM (APPC/VM) failure on the last data link with the file pool server
    • your virtual machine abends or is re-IPLed
    Note: If an abend occurs, the update session lock obtained by XEDIT will be deleted if sufficient storage is available for this additional processing.
  3. To change files in an SFS directory control directory, you must access the directory in read/write mode. Because CMS lets only one user at a time access an SFS directory control directory in read/write mode, no one can change a file while you are editing it.

    You can use XEDIT on files within a directory control directory that is accessed in read-only mode. No warning message is displayed, but because the directory is accessed in read-only mode, you cannot change the copy of the file in the directory by using XEDIT subcommands such as FILE and SAVE. To save the changes, you must save or file the file on a minidisk or directory you have accessed in read/write mode.

    To change files in a file control directory, you can access the directory in either read-only or read-write mode. (By default, when you access someone else's directory, the access mode is read-only.) To have XEDIT respect the read-only access for file control directories regardless of your file authority, use the CMS SET RORESPECT ON command. (See z/VM: CMS Commands and Utilities Reference for an explanation of this command.)

  4. The CMS RORESPECT setting may be used to prevent XEDIT from writing to a file control directory accessed read-only. To prevent XEDIT from locking a file in the directory so others may write to it, you may query the CMS setting and issue a LOAD subcommand with the NOLOCK option from your profile.
  5. If you XEDIT an SFS or BFS file that has been migrated (moved to DFSMS/VM-owned storage), it is automatically recalled if the CMS SET RECALL command is set to ON. (See z/VM: CMS Commands and Utilities Reference for an explanation of this command.) This may cause a slight delay before the file can be accessed. If CMS SET RECALL is OFF the file will not be recalled and an error message will be displayed.
  6. For the PROFILE, CTL, SIDCODE, INCR, UNTIL, MEMBER, WIDTH, WINDOW, BFSLINE, and NAMETYPE options, the operand must be specified; otherwise, the next option is interpreted as its operand. For example, in the PROFILE macroname option, macroname must be specified; if it is not, the next option is interpreted as the operand macroname.
  7. Once the XEDIT command has been executed, the XEDIT subcommand can be used to edit and display multiple files simultaneously (see XEDIT).
  8. You can also call the editor recursively (that is, using the CMS XEDIT command). This ability is particularly useful when applications are developed using the editor and its macro facilities to interface with the user, for example, HELP.

    When you call CMS XEDIT recursively, a new ring of files is begun that is independent of any previous ring(s).

  9. The MEMBER option and the NOUPDATE option have no effect when preceded by an option that automatically forces update processing. Also, options that usually force update processing are ignored when the MEMBER option or the NOUPDATE option precedes them.
  10. If full-screen CMS is set to ON before XEDIT writes to the screen, XEDIT issues the WINDOW SHOW CMSOUT command followed by WINDOW SHOW XEDIT or a WINDOW SHOW for the particular window that has been set up to display the file.
  11. The editor is kept in virtual storage as part of the CMS nucleus shared segment; the CMS user area is unused. As a result, assuming a large enough virtual machine, any CMS or CP command may be issued directly from the editor environment itself (if a SET IMPCMSCP subcommand is in effect).
  12. When an XEDIT command invokes the PROFILE macro, everything following the command name XEDIT is tokenized (truncated to eight characters), and then assigned to the argument string passed to the PROFILE macro as the first parameter.

    The editor does not examine any parameters that follow a closing right parenthesis on the XEDIT command.

    When you specify the NAMETYPE BFS option on the XEDIT command, your profile is called as a REXX function, and the untokenized, mixed case file ID (shown below as fileid2) is passed unchanged as a second argument string.

    Note: The second parameter (fileid2) is still enclosed in quotation marks if that is the way it was entered.

    This is useful when editing a BFS file because the path name may be up to 1023 bytes long, is case sensitive, and may contain blanks and other special characters, such as quotation marks. The XEDIT profile must be in REXX, not in EXEC or EXEC2, when the NAMETYPE BFS option is used. The return code is set to RC=5 if the profile returns an invalid result.

    Whether or not NAMETYPE BFS is specified, special substitution is done for a file ID enclosed in quotation marks. It is assumed this is a BFS path name containing special characters such as blanks or a (, and a place holder, the character ‘*’, is substituted in its place in the argument list for the first argument string so the profile option processing works correctly.

    An example of a way to obtain these argument strings from within your profile when the NAMETYPE BFS option is used is:
    PARSE ARG fileid1 ft fm '(' OPTIONS , fileid2
    In the example above, fileid1 can be:
    • The file name for a CMS file
    • A path name for a BFS file that does not contain any blanks or special characters
    • A placeholder for a file ID enclosed in quotation marks on the command invocation
  13. When you enter an XEDIT command for an SFS or minidisk variable-format file, trailing blanks are removed when it is filed (or saved).

    When the record format is variable (V) for a BFS file, trailing blanks are removed when it is filed (or saved), and a line containing all blanks is represented in the file as two BFSLINE values in a row. (The initial record format setting for a BFS file depends upon the BFSLINE option. See the BFSLINE option description on the XEDIT command for more information.)

  14. Update control comment records cannot be edited when the UPDATE option is in effect. Edit the update file without specifying any update options to change these records.
  15. Many languages have more characters than can be displayed using one-byte codes (KANJI, for example). A Double-byte Character Set (DBCS) represents these characters. The double-byte characters can appear in a sentence with characters from other languages displayed in 1-byte codes. Files containing double-byte characters are handled differently from files that contain only 1-byte characters.

    When specifying a BFSLINE value for use on files containing DBCS characters, ensure you use a value that will not conflict with DBCS characters. The hexadecimal code for a DBCS character must be X'0000', X'4040', or X'aabb', with aa and bb both being in the range of X'41' to X'FE'.

  16. The virtual storage required to edit a ring of one or more files is greater than the size of the files themselves. This includes storage necessary to manage the ring, the lines, the display, and other internal XEDIT storage needs.
  17. Unless BFSLINE lrecl is in effect when you XEDIT a BFS file, a blank line is inserted if two BFSLINE values are found in a row.
  18. The BFSLINE setting has no effect when a PUT, PUTD, GET, FILE, SAVE, or LOAD subcommand is used to read or write a CMS record file when NAMETYPE CMS is in effect.
  19. The BFSLINE option can also be used on the XEDIT subcommand from within an XEDIT session. For example, a user can enter:
    XEDIT a a a
    and then enter
    XEDIT pathname (BFSLINE NL NAMETYPE BFS
    on the XEDIT command line.
  20. Commit behavior of BFS files is different from that of SFS or minidisk files. For example, if the editor encounters an error when writing to a minidisk or SFS file, your changes are reversed and the original file is preserved. This is not the case for BFS files. The editor creates a copy of the file in XEDTEMP CMSUT1 on your A disk so you can recover your data if an error occurs when writing the file to the byte file system.
    If the editor is unable to create the XEDTEMP CMSUT1 file, you will receive a message describing the problem, and a second message:
       595E  Not able to create CMS file used for recovery.  Correct
             error or QQUIT to exit without writing file
    If the editor encounters an error while writing the byte file system file such that the contents of an existing file are damaged, you will receive a message describing the problem, and a second message to tell you that you must take action to recover your file.
       024E  File XEDTEMP CMSUT1 A1 contains file contents; use
             OPENVM PUT to recover file
  21. When a new BFS file is created, the owning UID established is the effective UID of the VM User ID on which the request was issued. The GID is the GID of the parent directory. Use OPENVM OWNER to change the defaults. Refer to z/VM: OpenExtensions Commands Reference or enter HELP OPENVM OWNER for more information.
  22. Permissions for a new BFS file are set based on the current value of the mask, with the exception of execute permissions, which are not set to ON. Use OPENVM PERMIT to change the defaults. See z/VM: OpenExtensions Commands Reference or enter HELP OPENVM for more information on these OPENVM commands.
  23. You can XEDIT path names only if they represent BFS regular files.
  24. When you are in a GUI environment, initially the GUI windows for rings are arbitrarily positioned on the workstation screen. You cannot control the initial position. However, you can move the windows once they are displayed using workstation controls such as a pointing device or keys.

    The initial size of your GUI XEDIT window is determined by your terminal emulator session setting. The window can be resized to a smaller size by using workstation controls to move the borders.

    When using XEDIT to edit a file in a GUI environment, the title bar of the GUI window contains the word "XEDIT".

    Note: It is recommended the workstation agent be configured to use a non-proportional font. If you elect to use proportional fonts in your xedit session, columns and rows may not appear to line up.
  25. Typically you would use the default BFSLINE option when XEDITing a file in an NFS-mounted file system.

    If the NFS-mounted file system is a minidisk or SFS directory, you must coordinate XEDIT's BFSLINE option with the VMNFS server options specified on the mount. This is necessary because the NFS-mounted file is changed into byte-stream format when read by XEDIT, and changed back into record format when written to the minidisk or SFS directory through NFS.

    If the remote CMS file is a Variable file, you could use lines=NL on the mount and the default BFSLINES NL in the XEDIT options. If the remote CMS file is a Fixed file, you could specify lines=none in the mount options and BFSLINES lrecl in the XEDIT options.

Responses

When editing a file that resides in an SFS FILECONTROL directory, if you have only read authority to the file and you do not specify the NOLOCK option, you receive the message:
   1299W  Warning: not authorized to lock fn ft fm
The editing session continues but the file is not locked.
The following messages are displayed only if you are using XEDIT in update mode:
   178I  Updating fn ft fm
         Applying fn ft fm
   1229I fn ft fm is empty
               .
               .
               .
   180W Missing PTF file fn ft fm
If the XEDIT work file, XEDTEMP CMSUT1, exists on a file mode accessed R/W as a result of a previous edit session that ended abnormally, you will receive the message:
   024E   File XEDTEMP CMSUT1 fm already exists
You can use the CMS TYPE command to examine the existing file. If you decide you want to keep it, use the CMS RENAME command to give it a new CMS file ID, or use OPENVM PUTBFS to move it into the byte file system. Refer to z/VM: OpenExtensions Commands Reference or enter HELP OPENVM PUTBFS for more information on this command. If the file is incorrect or incomplete, erase it and enter the command again.
If you try to XEDIT an existing empty file and a profile is not executed, you get the following message:
  556I  Editing existing empty file:

If you are in a GUI environment and fn ft are not specified for a CMS file, the XEDIT File ID window is displayed.

Messages and Return Codes

002E
File fn ft fm not found [RC=28]
003E
Invalid option: option [RC=24]
024E
File XEDTEMP CMSUT1 fm already exists [RC=28]
029E
Invalid parameter parameter in the option option field [RC=24]
033E
File is not a regular BFS file [RC=32]
048E
Invalid filemode mode [RC=24]
054E
Incomplete [or incorrect] fileid specified [RC=24]
062E
Invalid character in fileid {fn ft fm|pathname} [RC=20]
065E
option option specified twice [RC=24]
066E
option1 and option2 are conflicting options [RC=24]
069E
Filemode mode not accessed [RC=36]
070E
Invalid parameter parameter [RC=24]
104S
Error nn reading file fn ft fm from disk or directory [RC=31, 55, or 100]
109S
Virtual storage capacity exceeded [RC=104]
132S
File [fn ft fm] too large[: pathname] [RC=88]
137S
Error nn on STATE for fn ft fm [RC=88]
229E
Unsupported OS dataset, error nn [RC=80, 81, 82, or 83]
500E
Unable to unpack file fn ft fm [RC=88]
508E
LOAD must be the first subcommand in the profile [RC=3]
512E
This is not allowed in CMS subset mode [RC=100]
554E
Not enough virtual storage available [RC=104]
556I
Editing existing empty file:
571I
Creating new file:
622E
Insufficient free storage (for {MSGLINE|PFkey/PAkey|synonyms})
915E
Maximum number of windows already defined [RC=13]
927E
The virtual screen must contain at least 5 lines and 20 columns [RC=24]
928E
Command is not valid for virtual screen CMS [RC=12]
1019E
Network File System name is not allowed [RC=32]
1020E
Foreign host cannot be reached. The request returned return code rc and reason code rs [RC=55, 104]
1138E
File sharing conflict for file {fn ft fm|pathname] [RC=70]
1214W
File fn ft fm already locked SHARE
1215E
File fn ft fm is locked or in use by another user [RC=70]
1229E
fn ft fm is empty [RC=88]
1229I
fn ft fm is empty
1262S
Error nn opening file fn ft fm [RC=31, 55, 70, 76, 99, or 100]
1299W
Warning: Not authorized to lock file fn ft fm
1300E
Error nn {locking|unlocking} file fn ft {fm|dirname} [RC=55, 70, 76, 99, or 100]
2105E
Permission is denied [24]
2134E
Return code bpxrc and reason code bpxrs given on call to rtnname [for path name pathname] [RC=100]
2154E
File {fn ft fm|pathname} is migrated and implicit RECALL is set to OFF [RC=50]
2155E
DFSMS/VM error occurred during creation or recall of file {fn ft fm|pathname} [RC=51]
2526E
File or directory creation or file recall was rejected by a DFSMS/VM ACS routine; ACS routine return code acs rcode [RC=51]

Messages with Member Options:

007E
File fn ft fm is not fixed, 80-character records [RC=32]
033E
File fn ft fm is not a library [RC=32]
039E
No entries in library fn ft fm [RC=32]
167S
Previous MACLIB function not finished [RC=88]
622E
Insufficient free storage for reading map [RC=104]

Messages with Update Option:

007E
File fn ft fm is not fixed, 80-character records [RC=32]
007E
File fn ft fm does not have a logical record length greater than or equal to 80 [RC=32]
007E
File fn ft fm does not have the same format and record length as fn ft fm [RC=32]
007E
File fn ft fm is not fixed record format [RC=32]
104S
Error nn reading file fn ft fm from disk or directory [RC=31, 32, or 55]
174W
Sequence error introduced in output file: seqno1 to seqno2 [RC=32]
178I
Applying fn ft fm
179E
Missing or invalid MACS card in control file fn ft fm
180W
Missing PTF file fn ft fm
183E
Invalid {CONTROL|AUX} file control card [RC=32]
184W
./ S not first card in update file--ignored [RC=32]
185W
Non numeric character in sequence field seqno [RC=32]
186W
Sequence number not found [RC=32]
207W
Invalid update file control card [RC=32]
210W
Input file sequence error: seqno1 to seqno2 [RC=32]
317E
Number of AUX file types in control file fn ft fm exceeds 32 [RC=32]
570W
Update ft specified in the UNTIL option field not found
597E
Unable to merge updates containing ./ S cards [RC=32]
1262S
Error nn opening file fn ft fm [RC=31, 55, 70, 76, 99, or 100]

where return codes are:

0
Normal
3
LOAD must be the first subcommand
6
Subcommand rejected in the profile due to LOAD error, or QUIT subcommand has been issued in a macro called from the last file in the ring
12
Command is not valid for virtual screen
13
Maximum number of windows already defined
20
A character in the file name, file type, or path name is not valid.
24
Invalid parameters or options
28
Source file not found (UPDATE MODE), or library not found (MEMBER option), or specified PROFILE macro does not exist, or file XEDTEMP CMSUT1 already exists
31
A rollback occurred
32
Error during updating process, or file is not a library, or library has no entries, or file is not fixed, 80 char. records, or maximum number of AUX file types exceeded, or BFS file is not a regular file, or Network File System path name cannot be used
36
Corresponding minidisk or directory not accessed
50
File is DFSMS/VM migrated and automatic recall has been set to OFF (CMS SET RECALL command)
51
DFSMS/VM error
55
APPC/VM communications error or TCP/IP communications error
70
File sharing conflict or the minidisk file being opened is already open using CSL interfaces of DMSOPEN or DMSOPDBK
76
Connection error
80
An I/O error occurred while an OS data set or DOS file was being read or an OS or DOS disk was detached without being released
81
The file is an OS read-password-protected data set or a DOS file with the input security indicator on
82
The OS data set or DOS file is not BPAM, BSAM, or QSAM
83
The OS data set or DOS file has more than 16 user labels or data extents
88
File is too large and does not fit into storage, a previous MACLIB function was not finished, or an unsupported function was attempted with an empty file
99
A required system resource is not available
100
Error reading the file into storage
104
Insufficient storage available