Exporting Selected Objects

The export function saves the selected object types in an automatically-generated member or a sequential file.

Start of instruction setTo export one or more Entire Event Management objects

  1. Enter EXPORT in the Command===> line of any screen and press Enter.

    The Object Type window opens:

    Object Type

      17:42:55              *** ENTIRE EVENT MANAGEMENT ***                 95-04-16
      Srv    *                        - Main Menu -
    
    
         Console Services                 ------------------------------------------
                                          !         - Select Object Type -         !
          1  Logical Console              !                                        !
          2  Server                       ! __ ALL                                 !
                                          ! __ CALENDAR                            !
                                          ! __ CONSOLE                             !
         Administration                   ! __ LAYOUT                              !
                                          ! __ MESSAGE-LOG                         !
          3  Environment                  ! __ NODE                                !
          4  Automation                   ! __ PROFILE                             !
          5  Authorization                ! __ RANGE                               !
          6  Calendars                    ! __ RULE                                !
                                          ! __ SERVER                              !
          .  Exit                         ! __ USER                                !
          ?  Help                         !                                        !
          *  Commands                     ------------------------------------------
    
      Command ===> EXPORT___________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                                            Menu
    

    Notes:

    1. You can bypass this window by entering EXPORT <object-type> in the Command===> line and pressing Enter. For the object types Message Log and All (export whole environment), see Exporting Message Log and Exporting the Whole Entire Event Management Environment respectively.
    2. Each export data set or Natural member contains objects of the selected type. This also applies for execution in batch mode.
  2. Select an object type with the cursor and press Enter.

    A selection window opens (in our example, for CONSOLE):

    Select Logical Console

      17:42:55              *** ENTIRE EVENT MANAGEMENT ***                 95-04-16
      Srv    *                        - Main Menu -
    
    
         Console Services                 ------------------------------------------
                                          !       - Select Logical Console -       !
          1  Logical Console              !                                        !
          2  Server                       ! Sel Name     Aut                       !
                                          !     *_______ ___ _____________________ !
                                          ! **  ********  top of data  *********   !
         Administration                   ! __  Adabas    X                        !
                                          ! __  CICS                               !
          3  Environment                  ! __  ComplCmd                           !
          4  Automation                   ! __  Complete                           !
          5  Authorization                ! __  Exec      X                        !
          6  Calendars                    ! __  Netpass                            !
                                          ! __  Network   X                        !
          .  Exit                         ! __  Operator  X                        !
          ?  Help                         ! __  Process   X                        !
          *  Commands                     ------------------------------------------
     NCL0701 Please select Logical Console to work with.
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                    Down                    Menu
    
  3. Select one object (in our example the console Adabas) with the cursor and press Enter.

    If you selected the object types: Console (our example), Rule, Server, Profile or User, the following window opens:

    Export Related Object Types

      17:43:38              *** ENTIRE EVENT MANAGEMENT ***                 95-04-16
      Srv    *                        - Main Menu -
    
    
         Console Services                 ------------------------------------------
                                          !       - Select Logical Console -       !
          1  Logical Console              !                                        !
          2  Server                       ! Sel Name     Aut                       !
                                          !     *_______ ___ _____________________ !
                                          ! **  ********  top of data  *********   !
         Administration                 +---------------------------+              !
                                        !  Export                   !              !
          3  Environment                !                           !              !
          4  Automation                 !  Related                  !              !
          5  Authorization              !                           !              !
          6  Calendars                  !  Object Types?   N        !              !
                                        !                           !              !
          .  Exit                       +---------------------------+              !
          ?  Help                         ! __  Process   X                        !
          *  Commands                     ------------------------------------------
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                    Down                    Menu
     NCL0701 Please select Logical Console to work with.
    

    The default is "N" (no).

  4. Enter "Y" to export the related objects too. For a list of the related objects, see the subsection Hierarchy of the Object Types.

  5. Press Enter.

    The Export Object window opens:

    Export Object

      17:45:44              *** ENTIRE EVENT MANAGEMENT ***                 95-04-16
      +---------------------------------------------------------------------------+
      !                              - Export Object -                            !
      !                                                                           !
      !   Location     ==> SEQ                                                    !
      !   Library      ==> ________                                               !
      !   Run          ==> 1                                                      !
      !   Dsname       ==> ______________________________________________________ !
      !   Volser       ==> ______                                                 !
      !   Node         ==>                                                        !
      !  ---------------------------------------                                  !
      !   Object Type  ==> Console                                                !
      !   Name         ==> ADABAS                                                 !
      !                                                                           !
      !                                                                           !
      !                                                                           !
      ! Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--P !
      !       Help        End         Expor                                       !
      !                                                                           !
      +---------------------------------------------------------------------------+
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                    Down                    Menu
     NCL0701 Please select Logical Console to work with.
    
  6. Enter values for the input fields as described under the heading Fields: Export Object.

  7. Press PF5 (Expor) to start the export.

    Warning:
    Do not press any key while export is running.

    During export a window opens briefly, which informs you about the object currently being exported. This window displays name and type of the object.

    When export is finished, this is indicated by the message:

    Function performed.

PF Keys: Export Objects

You can perform the following functions from the Export Object window using these PF keys:

Key Name Function
PF1 Help Display a help screen for this window.
PF3 End Return to Entire Event Management.
PF5 Expor Start the export function.

Fields: Export Object

The input and output fields in the Export Object window are explained in the following table:

Field Description
Location
Enter the target location to which to export the object. Possible values:
NAT Natural Source.
SEQ Sequential file is the default unit. Use this when exporting a large number of objects.
Library If Location is NAT, you must enter a target Library for the exported objects. If Location is SEQ, leave this field blank.
Run The Import/Export Utility generates a new run number for each export run of each object type. This field is not modifiable.
Dsname
If Location is SEQ, enter the name of a sequential file:
z/OS, z/VSE: The sequential file to which you are exporting must first be allocated and cataloged, as follows:
RECFM=FB,LRECL=240,BLKSIZE=24000,DSORG=PS

If the sequential file already exists, it will be overwritten.

BS2000/OSD: For each export, allocation is performed automatically by the Import/Export Utility.
If Location is NAT, leave this field blank.
Volser If Location is SEQ and the operating system is z/VSE, you must enter a valid VOLSER. If Location is NAT, leave this field blank.
Node If Location is SEQ, you must enter a valid node. If Location is NAT, leave this field blank.
Object Type This field contains the selected object type and is not modifiable.
Depending on the object type selected, one of the following fields appears beneath the Object Type field (if you select Rule, both the Name and Console fields appear). To enter a new value in these fields, just type over the old value:
Name If Object Type is Calendar, Console, Layout, Rule, Range or Profile, name selected appears here. Enter a prefix followed by an asterisk (*) to export a range of objects for this object type, which fulfil the description. You can export all records of this object type, if you enter an asterisk (*) without a prefix.
Node If Object Type is Node, the node number (1 to 255) appears here.
Key If Object Type is Server, the server number appears here.
Userid If Object Type is User, the User ID appears here.
Console If Object Type is Rule, the name of the related console appears here.

Using Wildcards

You can use wildcards to enter selection criteria for the object. For example, enter AD* in the Name field for Console to export the Console AD and all those beginning with the prefix AD. Enter * in the field to export all Consoles.

Abnormal Termination of Export

Export can terminate abnormally for several reasons:

  • You are attempting to export an object type with a related object that is not available.

If Location is NAT:

  • You could be attempting to write more than 99 members or to select more than 99 object types (there is no limitation, if Location is SEQ).

  • Natural Security is installed, but

    • the Library to which you are exporting is not a STEPLIB to SYSNCLIE;

    • you are not authorized for the Library to which you are exporting.

  • The Library to which you are exporting must not contain a member with the prefix EVDIR. This prefix is reserved for internal administration.


Exporting Message Log

Start of instruction setTo export the object type Message Log

  1. Follow steps (1) to (3) (select Message Log) in the subsection Exporting Selected Objects.

  2. Press Enter.

    The following window opens:

    Export Message Log

      17:46:21              *** ENTIRE EVENT MANAGEMENT ***                 95-04-16
      +---------------------------------------------------------------------------+
      !                             - Export Message Log -                        !
      !                                                                           !
      !   Location     ==> SEQ                                                    !
      !   Run          ==> 1                                                      !
      !   Dsname       ==> ______________________________________________________ !
      !   Volser       ==> ______                                                 !
      !   Node         ==> ___                                                    !
      !  ---------------------------------------                                  !
      !   Object Type  ==> Message Log                                            !
      !   Console      ==>                                                        !
      !                                                                           !
      !   Time from    ==> Date : 16.04.1995  Time : 00:00:00                     !
      !   Time to      ==> Date : 16.04.1995  Time : 23:59:59                     !
      !                                                                           !
      ! Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--P !
      !       Help        End         Expor                                       !
      !                                                                           !
      +---------------------------------------------------------------------------+
      Command ===> EXPORT___________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                                            Menu
    
  3. Enter values for the input fields as described in the following.

  4. Press PF5 (Expor) to start the export.

    During export a window opens briefly, which informs you about the object currently being exported. This window displays name and type of the object.

    When export is finished, this is indicated by the message:

    Function performed.

    Note:
    You should export the Message Log in batch mode to avoid encountering any limits.

Fields: Export Message Log

The input and output fields in the Export Message Log window are explained in the following table:

Field Description
Location SEQ sequential file is the target location to which the object type is exported. This field is not modifiable.
Run The Import/Export Utility generates a new run number for each export run. This field is not modifiable.
Dsname
z/OS, z/VSE: The sequential file to which you are exporting must first be allocated and cataloged, as follows:
RECFM=FB,LRECL=240,BLKSIZE=24000,DSORG=PS

If the sequential file already exists, it will be overwritten.

BS2000/OSD: For each export, allocation is performed automatically by the Import / Export Utility.
Volser / Node You must enter a valid VOLSER and node.
Object Type This field contains the selected object type and is not modifiable.
Console You must enter the name of the console for which you want to export logged messages. Enter * for all consoles.
Time-from
Date Default is current day. Enter a valid date. Format conforms to Date Format in Field Descriptions: Set Session Parameters in section Using Entire Event Management).
Time Default is 00:00:00 (HH:II:SS). Enter a valid time.
Time-to
Date Default is current day. Enter a valid date. Format conforms to Date Format in Field Descriptions: Set Session Parameters in section Using Entire Event Management).
Time Default is 23:59:59 (HH:II:SS). Enter a valid time. (Time-from must be earlier than Time-to).