This document demonstrates the use of the Entire Event Management Import/Export Utility in batch mode. NCLnnn.SRCE provides the JCL examples E-EXSYS2, E-EXSYS3, E-IMSYS2 and E-IMSYS3 which show how to use the export and import functions respectively to transport data from/to Entire Event Management System Files 2 and 3. Replace the symbols in brackets <> according to your installation.
Note:
Be sure that the LFILE assignments correctly reflect your
source/target environment. Take particular care to use the correct version of
System File 1 when importing objects to System File 2.
During import or export, information about the process is written to SYSOUT. When SYSNCLIE terminates, it writes a final message to SYSOUT to inform you whether the function was terminated successfully or not.
| Field | Description | Values | Format | Use |
|---|---|---|---|---|
| LOCATION | Container for objects being imported or exported. | NAT or SEQ | A3 | E/I |
| LIBRARY | Specifies container, if LOCATION=NAT | <LIBRARY> | A8 | E/I |
| DSNAME | Specifies container, if LOCATION=SEQ | <DSNAME> | A54 | E/I |
| VOLSER | If LOCATION=SEQ | <VOLSER> | A6 | E/I |
| NODE | If LOCATION=SEQ | <NODE> | N3 | E/I |
| OBJECT-TYPE 1 | Entire Event Management object types from System File 2. |
CALENDAR |
A20 | E/I |
| From System File 3 ! | MESSAGE-LOG | |||
| Import/export whole environment from System File 2. | * | |||
| NAME | Name of the OBJECT-TYPE. Use * as wildcard to select range of objects. Leave blank if OBJECT-TYPE = *. If object type is MESSAGE-LOG, enter the name of the console or * for all consoles. | * | A32 | E |
| Export all objects of one type. | * | A32 | E |
1 Required for input when LOCATION=NAT in combination with RUN-NUMBER.
| Field | Description | Values | Format | Use |
|---|---|---|---|---|
| CONSOLE | Required only if OBJECT-TYPE= RULE. Otherwise, leave blank. | <CONSOLE> | A32 | E |
| RELATION | If RELATION=Y, the following OBJECT-TYPEs can be
exported with their related object types:
Default is "N". |
Y / N | A1 | E |
| PRINT-EXPORT-LIST | See PRINT-EXPORT-LIST. | blank or any character | A1 | I |
| RUN-NUMBER | Required if LOCATION=NAT. Run number for each OBJECT-TYPE. | 1 to 99 | N2 | I |
| MODE | Import mode:
A = Add (default) |
A /S/ U | A2 | I |
| ERROR-LIMIT | Counter for the error limit. Specifies number of errors permitted before terminating import program. Default is "5". | 1 to 99 | N2 | I |
| USER-ID | User ID to log on to the Entire System Server, indicated by the parameter NODE. | A8 | E/I | |
| The following fields are for the object type MESSAGE-LOG only: | ||||
| DATE-FROM | Enter a valid date. DATE-FROM must not be later than DATE-TO. | Format as in Session Parameters | A10 | E |
| TIME-FROM | Enter a valid time. | HH:II:SS | A8 | E |
| DATE-TO | Enter a valid date. | Format as in Session Parameters | A10 | E |
| TIME-TO | Enter a valid time. TIME-FROM must be earlier than TIME-TO. | HH:II:SS | A8 | E |
If this parameter is specified with any value not=blank, an EXPORT-LIST is written to SYSOUT.
This list contains information for the selected target environment. An import run is not started. This list documents the user's selection regarding the target environment for the preceding export run(s) (Location and Library or Location, DSNAME and Node). The list contains the Run Number, Date, Time, Object Type and Object Name for the previously executed export run in this target environment.
To export every CONSOLE without related objects to a sequential file:
LOGON SYSNCLIE EXPORT LOCATION=SEQ;DSNAME=<dataset name>;NODE=<ESY-Node>;% OBJECT-TYPE=CONSOLE;NAME=*;RELATION=N;% USER-ID=<user ID>
To import all CONSOLEs from a Natural member with RUN-NUMBER=1, in update mode, with a maximum of 5 errors or 10 warnings:
LOGON SYSNCLIE IMPORT LOCATION=NAT;LIBRARY=SYSNCLIE;RUN-NUMBER=1;% OBJECT-TYPE=CONSOLE;% MODE=U;ERROR-LIMIT=5;