Generating Data Store samples

To create the Data Store samples:

Select option 3 from the EQQJOBS application menu. 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 input. Enter the 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 input. Enter a JOB statement that follows standard JCL syntax and your installation standards.

Message library name

Required input. Enter the name of the library that contains the scheduler messages (SMP/E target DDNAME SEQQMSG0).

Parameter library

Required input. Enter the name of a library that will contain the initialization statements. This library must be allocated by the user. Use a name different from that of the controller and tracker parameter library.
Press Enter, and this 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 input. Enter 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 input. Enter 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 input. Enter 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 input. Enter a volume that will be used by sample job EQQPCS04 to allocate the primary data sets.

STEPLIB dsname

Optional. Enter the 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. Enter the 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. Enter the password for the VSAM catalog if the catalog is password-protected.
Press Enter, and this 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 input. Enter the Data Store reserved output destination. It must correspond to DSTDEST parameter in RCLOPTS option.

Connection Type

Required input. Enter the connection method used to handle communication between FN/FL tasks and Data Store. It can be SNA or XCF.

SNA Data Store luname

Enter Data Store VTAM® application name if SNA connection type has been chosen.

SNA Controller luname

Enter controller FN task VTAM® application name if SNA connection type has been chosen.

Xcf Group

Enter the name of XCF group if XCF connection type has been chosen.

Xcf Data Store member

Enter the name of Data Store XCF member if XCF connection type has been chosen.

Xcf FL task member

Enter the name of FL task XCF member if XCF connection type has been chosen.

Job data retention period

Enter 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

Enter the maximum number of user sysout lines to be stored. The range is 0 to 10000.

Joblog retention period

Enter 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

Specify the Controller TCP/IP host name if you chose TCP in Connection type.

TCP Controller port number

Specify the Controller TCP/IP port number if you chose TCP in Connection type.
Press Enter when 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 is used at various stages in 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