File | 203 |
---|---|
Statement | PROCESS
|
Task | This view makes it possible to write data to a file or to an LMS element. See also WRITE-SPOOL Programming Notes at the bottom of this view description. |
Code | Text |
---|---|
530 | Access denied by Security Facility. |
531 | Password missing or incorrect. |
551 | Member not specified. |
556 | File is in use. |
560 | Segment length greater than 253. |
565 | Syntax error in dataset name. |
590 | End-of-data reached during UPDATE-INPLACE. |
592 | Record length error for variable UPDATE-INPLACE. |
678 | Member already exists. |
692 | You are not permitted to access member. |
699 | Not enough main storage available. |
700 | Invalid value specified (DSORG/RECFM/TYPE). |
701 | DSNAME missing. |
722 | Requested dataset not found. |
733 | User ID does not exist. |
737 | No more index space for inserting record. |
798 | Task was not started under TSOS. |
799 | Entire Systems Management Adapter internal error. |
854 | Permanent I/O error. |
856 | Operator unable to mount volume. |
870 | RECORD field not in search buffer. |
872 | Record format not supported. |
873 | Record length missing. |
874 | RECORD-LENGTH > LRECL. |
875 | Position of data field > RECORD-LENGTH. |
881 | Error occurred while opening file. |
882 | Error occurred while closing file. |
883 | Dataset is full. |
889 | Permanent I/O error while writing dataset. |
899 | Permanent I/O error while reading dataset. |
981 | Invalid value specified (BLKCTRL/BLKSIZE/LRECL). |
982 | Error during use of ISAM key. |
983 | UPDATE-INPLACE not supported by LMS. |
985 | Access to tape file not allowed. |
991 | Unknown product. |
993 | Open error. |
998 | Member not found. |
Dictionary Field Name | Format/
Length/ Desc/Mu |
Description |
---|---|---|
DISP | (A3) | Disposition of file. Possible values: |
D | MOD Add records to the end of sequential file. | |
NEW Create new file. | ||
STR Only for ISAM files: | ||
Replace or add records identified by the | ||
value in KEY. | ||
DSNAME | (A54) | Required. Fully qualified file name. |
D | ||
DUPLICATE-KEY | (A3) | For ISAM only: |
D | NO Default. No duplicate keys allowed. | |
YES Duplicate keys allowed. | ||
ELEMENT | (A64) | Name of the LMS element to be written. |
D | ||
ELEMENT-PASSWORD | (A8) | Password for protected LMS element. |
D | ||
ELEMENT-RECORD-TYPE | (N3) | Record type (LMS only). |
D | ||
ELEMENT-TYPE | (A8) | Type of LMS element to be written. |
D | Types C and L are not supported. | |
ELEMENT-USER-DATE | (A14) | Is written as element information into LMS library. Format: YYYY-MM-DDaaaa, where aaaa can be any 4-character string. |
D | ||
ELEMENT-USER-TIME | (A8) | Is written as element information into LMS library. Format: HH:MM:SS. |
D | ||
ELEMENT-VERSION | (A24) | Version of LMS element to be written. |
D | ||
EXPIRATION-DATE | (A5) | The file's new expiration date in format YYDDD. |
D | ||
EXPIRATION-DATX | (D) | Expiration date in Natural format. |
D | ||
FUNCTION | (A8) | Function to be performed. Possible options: |
D | Blank Default. Write a record. | |
CLOSE All records have been written. | ||
Specify this on the last request. | ||
IDENTIFIER | (A8) | Required if multiple update views are executing in parallel. All requests for the same view must have the same identifier. |
D | ||
KEY | (A253) | ISAM key. |
D | ||
LMS-RESET-FLAG | (A3) | If YES is specified in this field with FUNCTION=CLOSE, all previous writes for this LMS element are reset. |
D | ||
PAD | (N2) | Only for ISAM: padding factor (default is 15). |
D | ||
PASSWORD | (A8) | Password for protected file. |
D | ||
PRODUCT | (A1) | Access method used: |
D | M LMS | |
RECORD | (A253) | Record to be written. |
D | ||
RECORD-LENGTH | (N5) | Length of record (used only if record format is variable). Can be omitted. |
D | ||
RECORD-NUMBER | (N9) | Number of record to be written. |
D | ||
SEGMENT-LENGTH | (N3) | Length of segment. |
D | ||
SEGMENT-NUMBER | (N5) | Number of segment. If SEGMENT-NUMBER=1, a new logical record is started. If SEGMENT-NUMBER > 1, the segment is a continuation. |
D | ||
TAPE-UNLOAD | (A3) | Unload TAPE during CLOSE: |
D | NO Rewind tape to the beginning (default). | |
YES Unload tape. | ||
UPDATE-INPLACE | (A3) | Possible options: |
D | NO Don’t update existing record in place | |
(default). | ||
YES Update record in place. |
WRITE-FILE
is an UPDATE
view, that is,
data is transmitted from the Natural program (client side) to ESA (server
side).
The Entire Systems Management Adapter view WRITE-FILE
returns error codes and error messages that describe whether the requested
operation has been executed successfully or not. The DEFINE DATA
section of the Natural program should only contain the fields shown
below:
1 WRITE-SPOOL VIEW OF WRITE-SPOOL 2 ERROR-CODE 2 ERROR-TEXT 2 SYSTEM-MESSAGE-CODE 2 SYSTEM-CODE
These fields in DEFINE DATA
are the fields returned
from the WRITE-FILE
view in Entire Systems Management Adapter to
the calling Natural program. It is not necessary to define any other fields in
the DDM; accessing any fields other than those above may lead to unpredictable
results.