Generating Data Store samples

To create the Data Store samples, perform the following steps:
  1. From the EQQJOBS application menu, select option 3. The following panel is displayed:
    Figure 1. EQQJOBS5 - Create Data Store samples
    EQQJOBS5 ----------------- CREATE DATA STORE SAMPLES --------------------
    Command ===>
    
    The data set names specified on this panel should be fully qualified
    names without any enclosing apostrophes.
    
    Enter the name of the output library:
    
    Sample job JCL        ===> CCOPC.OPCA.JCLDS__________
    
    Job statement information:
    
    ===> //SYSPROG1 JOB (111111,2222),'OPCESA BATCH',CLASS=B,MSGCLASS=H,__
    ===> //         MSGLEVEL=(1,1),NOTIFY=SYSPROG______________________________
    ===> ______________________________________________________________________
    ===> ______________________________________________________________________
    
    The following data set names are used by one or more of the generated jobs.
    Message library name  ===> OPC.SEQQMSG0_______________________________
    Parameter library     ===> CCOPC.OPCEDS.PARM__________________________
    
    
    Press ENTER to continue
    Sample job JCL
    Required. Name of the library to which you want the generated Data Store samples written. The library must be allocated before you generate the Data Store samples. Ensure that the library that you specify has sufficient directory blocks to store all the sample members that are generated by EQQJOBS (see Data Store samples generated by the EQQJOBS dialog).
    Job statement information
    Required. The JOB statement that follows standard JCL syntax and your installation standards.
    Message library name
    Required. Name of the library where to store the scheduler messages (SMP/E target DDNAME SEQQMSG0).
    Parameter library
    Required. Name of the library where to store the initialization statements. Use a name different from that of the controller and tracker parameter library. Ensure that this library is allocated.
  2. Click Enter. The following panel is displayed:
    Figure 2. EQQJOBS6 - Create Data Store samples
     EQQJOBS6 ----------------- CREATE DATA STORE SAMPLES --------------------
    Command ===> 
    
    Enter the following required job stream parameters:
    Non-VSAM dsn prefix   ===> CCOPC.OPCA________________ 
    VSAM dsn prefix       ===> CCOPC.OPCAV_______________ 
    Unit name             ===> 3390____     Default unit name 
    Primary volume serial ===> PROD01       Primary volume serial for VSAM 
    
    
    
    The following information is optional:
    STEPLIB dsname        ===> OPC.SEQQLMD0_______________________________
    VSAMCAT dsname        ===> ______________________________________________
    VSAM password         ===> ________
    
    
    
    
    
    Press ENTER to continue
    Non-VSAM dsn prefix
    Required. The qualifiers that prefix the non-VSAM data set names. The scheduler adds a low-level qualifier to the prefix to uniquely identify each Data Store non-VSAM data set.
    VSAM dsn prefix
    Required. The qualifiers that prefix the VSAM data set names. The scheduler adds a low-level qualifier to the prefix to uniquely identify each Data Store VSAM data set.
    Unit name
    Required. A device name that is valid at your installation. This could be a device type, for example 3390, or a group name, for example PROD or TEST.
    Primary volume serial
    Required. The volume that will be used by sample job EQQPCS04 to allocate the primary data sets.
    STEPLIB dsname
    Optional. Name of the scheduler load module library, if the load modules are not in a data set included in an active LNKLST member.
    VSAMCAT dsname
    Optional. Name of a catalog in which VSAM data sets are to be defined, if they are not to be defined in the master catalog.
    VSAM password
    Optional. The password for the VSAM catalog, if the catalog is password-protected.
  3. Click Enter. The following panel is displayed:
    Figure 3. EQQJOBS7 - Create Data Store samples
    EQQJOBS7 ----------------- CREATE DATA STORE SAMPLES ---------------------
     Command ===>                                                              
                                                                               
     Enter the parameters to build DSTOPTS and DSTUTIL options samples:        
                                                                               
     Reserved destination          ===> OPCX____                               
     Connection type               ===> SNA (SNA/XCF/TCP)                      
       SNA Data Store luname       ===> I9PC45AA (only for SNA connection)     
       SNA Controller luname       ===> I9PC45RA (only for SNA connection)     
       Xcf Group                   ===> ________ (only for XCF connection)     
       Xcf Data Store member       ===> ________ (only for XCF connection)     
       Xcf FL task member          ===> ________ (only for XCF connection)     
       TCP Controller host name:                 (only for TCP connection)     
       ===> ____________________________________________________               
       TCP Controller port number  ===> _____    (only for TCP connection)     
     Jobdata ret. period           ===> 2_ (number of days)                    
     JobLog retrieval              ===> Y (Y/N)                                
       Max n. lines to store       ===> 0______                                
       JobLog  ret. period         ===> 5_ (number of days)                    
                                                                               
     Press ENTER to create sample job JCL 
    Reserved destination
    Required. The Data Store reserved output destination. It must correspond to the DSTDEST parameter set in RCLOPTS option.
    Connection Type
    Required. The connection method used to establish the communication between FN/FL tasks and Data Store. It can be TCP, SNA, or XCF.
    SNA Data Store luname
    The Data Store VTAM® application name, if SNA connection type has been set.
    SNA Controller luname
    The controller FN task VTAM® application name, if SNA connection type has been set.
    Xcf Group
    Name of XCF group, if XCF connection type has been chosen.
    Xcf Data Store member
    Name of Data Store XCF member, if XCF connection type has been chosen.
    Xcf FL task member
    Name of the FL task XCF member, if XCF connection type has been chosen.
    Job data retention period
    The Data Store structured information retention period. It consists of the interval in days used by the online cleanup and is necessary to be able to use the Restart and Cleanup feature.
    Joblog retrieval
    Specify if the joblog retrieval must be enabled. This means that the Data Store will save the unstructured data in the joblog.
    Max n. of lines to store
    The maximum number of user sysout lines to be stored. The range is 0 to 10000.
    Joblog retention period
    The Data Store unstructured information retention period. It consists of the interval in days used by the online cleanup and is necessary to enable the Joblog Browse function.
    TCP Controller host name
    The controller TCP/IP host name, if you set TCP in Connection type.
    TCP Controller port number
    The controller TCP/IP port number, if you set TCP in Connection type.
  4. Click Enter after you have entered the information on panel EQQJOBS7. The dialog now generates several members in the output library that you specified. These members, which are described in Data Store samples generated by the EQQJOBS dialog, are used at various stages of the installation:
Table 1. Data Store samples generated by the EQQJOBS dialog
Member Sample Description
EQQCLEAN Sample procedure invoking EQQCLEAN program
EQQDSCL Batch Clean Up sample
EQQDSCLP Batch Clean up sample parameters
EQQDSEX Batch Export sample
EQQDSEXP Batch Export sample parameters
EQQDSIM Batch Import sample
EQQDSIMP Batch Import sample parameters
EQQDSRG Batch sample reorg
EQQDSRI Batch Recovery index
EQQDSRIP Batch Recovery index parameters
EQQDST Sample procedure to start Data Store
EQQDSTP Parameters for sample procedure to start Data Store
EQQPCS04 Allocate VSAM data sets for Data Store