Start Coded Data Store (STRCDSRDAR)
The Start Coded Data Store (STRCDSRDAR) command allows you to
store reports in OnDemand. During this process the report is broken
into segments, indexed, compressed, and stored on disk for
retrieval and later migration to optical or tape media if
desired.
| Keyword |
Description |
Choices |
Notes |
| REPORT |
Report name |
Character value |
Required, Positional 1 |
| VERSION |
Version |
1-99, 01, *HIGHEST |
Optional |
| TEXT |
Text 'description' |
Character value, *BLANK |
Optional |
| FILE |
Input file |
Single values: *SPLF
Other values: Qualified object name |
Optional |
| Qualifier 1: Input file |
Name |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| MBR |
Member |
Name, *FIRST, *LAST |
Optional |
| SPLF |
Spooled file |
Name |
Optional |
| JOB |
Job name |
Single values: *
Other values: Qualified job name |
Optional |
| Qualifier 1: Job name |
Name |
| Qualifier 2: User |
Name |
| Qualifier 3: Number |
000000-999999 |
| SPLNBR |
Spooled file number |
1-999999, *ONLY, *LAST, *ANY |
Optional |
| JOBSYSNAME |
Job system name |
Name, *ONLY, *CURRENT,
*ANY |
Optional |
| CRTDATE |
Spool file created |
Single values: *ONLY, *LAST
Other values: Element list |
Optional |
| Element 1: Creation date |
Date |
| Element 2: Creation time |
Time, *ONLY, *LAST |
| DLTINPUT |
Delete input file |
*NO, *YES |
Optional |
| SBMJOB |
Submit to batch |
*YES, *NO |
Optional |
| JOBD |
Job description |
Qualified object name |
Optional |
| Qualifier 1: Job description |
Name, QRDARS400 |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| RESTART |
Restart |
*NO, *YES |
Optional |
Report name (REPORT)
Specifies the name of the report to process.
This is a required parameter.
Note: If you press the F4 key for this parameter while
prompting the command, a list of all the valid entries is presented
to you.
Version (VERSION)
Specifies which version of the report definition is used to
store the report.
- 01
- The first version of the report definition is used.
- *HIGHEST
- The highest defined version of the report definition is
used.
- 01-99
- Specify the version number of the report to use.
Text 'description' (TEXT)
Specifies text that briefly describes the storing of this
report. This text becomes the description of the stored report that
is presented to the end user.
- *BLANK
- No text is specified. The report description from the report
definition is used as the text.
- 'description'
- Specify no more than 50 characters of text, enclosed in
apostrophes.
Input file (FILE)
Specifies where to find the report data to store.
Single values
- *SPLF
- The report data is read from the spooled file specified by the
SPLF, JOB, and SPLNBR parameters.
Qualifier 1: Input file
- name
- Specify the name of the database file that contains the report
data to store. The first character in each line of this data must
contain a valid ASA forms control character.
Qualifier 2: Library
- *LIBL
- All libraries in the job's library list are searched until the
first match is found.
- *CURLIB
- The current library for the job is where the file is located.
If no library is specified as the current library for the job, QGPL
is used.
- name
- Specify the name of the library where the database file is
located.
Member (MBR)
Specifies the name of the database member which contains the
report data to store.
- *FIRST
- The first member in the database file contains the report data
to store.
- *LAST
- The last member in the database file contains the report data
to store.
- member-name
- Specify the name of the database member that contains the
report data to store.
Spooled file (SPLF)
Specifies the name of the spooled file to use as input to the
store process. This is the file name that was specified by the user
program when the file was created, or the name of the device file
used to create this file.
Job name (JOB)
Specifies the name of the job which produced the spooled
file.
- *
- Use the job from which this command is entered.
- job-name
- Specify the name of the job to use. If no job qualifier is
given, all of the jobs currently in the system are searched for the
simple job name. If duplicates of the specified name are found, a
list of messages containing the qualified job names of all
duplicates is displayed.
- user-name
- Specify the name that identifies the user profile under which
the job is run.
- number
- Specify the job number assigned by the system.
Spooled file number (SPLNBR)
Specifies, by number, which of the job's spooled files to
store.
- *ONLY.
- Only one spooled file in the job has the specified file name;
therefore, the number of the spooled file is not necessary.
- *LAST
- The spooled file with the highest number and the specified file
name is used.
- *ANY
- The spooled file number is not used to determine which spooled
file is used. Use this value when the job system name parameter or
the spooled file create date and time parameter is to take
precedence over the spooled file number when selecting a spooled
file.
- spooled-file-number
- Specify the number of the spooled file having the specified
file name to use.
Job system name (JOBSYSNAME)
Specifies the name of the system where the job that created the
spooled file (JOB parameter) ran. This parameter is considered
after the job name, user name, job number, spooled file name, and
spooled file number parameter requirements have been met.
- *ONLY
- There is one spooled file with the specified job name, user
name, job number, spooled file name, spooled file number, and
spooled file create date and time.
- *CURRENT
- The spooled file created on the current system with the
specified job name, user name, job number, spooled file name,
spooled file number, and create date and time is used.
- *ANY
- The job system name is not used to determine which spooled file
is used. Use this value when the spooled file create date and time
parameter is to take precedence over the job system name when
selecting a spooled file.
- job-system-name
- Specify the name of the system where the job that created the
spooled file ran.
Spool file created (CRTDATE)
Specifies the date and time the spooled file was created. This
parameter is considered after the job name, user name, job number,
spooled file name, spooled file number, and job system name
parameter requirements have been met.
The possible single values are:
- *ONLY
- There is one spooled file with the specified job name, user
name, job number, spooled file name, spooled file number, and job
system name.
- *LAST
- The spooled file with the latest create date and time of the
specified job name, user name, job number, spooled file name,
spooled file number, and job system name is used.
The possible create date value is:
- spooled-file-create-date
- Specify the date the spooled file was created.
The possible create time values are:
- *ONLY
- There is one spooled file with the specified job name, user
name, job number, spooled file name, spooled file number, job
system name, and spooled file create date.
- *LAST
- The spooled file with the latest create time of the specified
job name, user name, job number, spooled file name, spooled file
number, job system name, and spooled file create date is used.
- spooled-file-create-time
- Specify the time the spooled file was created.
Delete input file (DLTINPUT)
Specifies whether the input report is deleted after the report
data is successfully stored by OnDemand. An unsuccessful STRCDSRDAR
does NOT delete the input.
- *NO
- The input report data is kept.
- *YES
- The input report data is deleted.
Submit to batch (SBMJOB)
Specify if you want to store the specified report interactively
or in a batch job.
- *YES
- This command should be submitted to run in a different
job.
- *NO
- This command should be run within the current job. If you are
entering this command from a terminal, this will prevent you from
doing any other work from this terminal session until this command
completes.
Job description (JOBD)
Specifies the name of the job description used for the submitted
job.
Qualifier 1: Job description
- QRDARS400
- The QRDARS400 job description is used as the job description
for the submitted job.
- name
- Specify the name of the job description used for the job.
Qualifier 2: Library
- *LIBL
- All libraries in the job's library list are searched until the
first match is found.
- *CURLIB
- The current library for the job is used to locate the job
description name. If no library is specified as the current library
for the job, QGPL is used.
- name
- Specify the name of the library where the job description name
is located.
Restart (RESTART)
Specifies whether this is to restart a run that was previously
interrupted. When STRCDSRDAR is unsuccessful because of an error, a
message is issued in the QPRLRCDS printer file that tells you when
you must specify *YES for this parameter.
- *NO
- This is not a restart of a previously failed run.
- *YES
- This is to restart a previously failed STRCDSRDAR run. This
value can not be specified when processing a report type of
UBND.
Example 1: Simple Example
STRCDSRDAR REPORT(CHECKSTMTS) SPLF(CKSTMTPRTF)
This command submits a job to batch to capture the CKSTMTPRTF
spooled file from the current job into OnDemand Spool File
Archive.
Example 2: More Complex Example
STRCDSRDAR REPORT(CHECKSTMTS) SPLF(CKSTMTPRTF)
JOB(123456/OPERATOR/NIGHTBATCH)SPLNBR(*LAST)
SBMJOB(*NO)
This command runs interactively to capture the last occurrence
of the CKSTMTPRTF spooled file from a nightly batch job called
NIGHTBATCH.
*ESCAPE Messages
- CPF3342
- Job &5/&4/&3 not found.
- CPF3343
- Duplicate job names found.
- CPF3344
- File &1 number &8 no longer in the system.
- CPF3492
- Not authorized to spooled file.
- CPF3C40
- Spooled file &4 not found.
- RDR0101
- Processing of STRCDSRDAR failed for &1. Rerun STRCDSRDAR
and specify RESTART(&2).
- RDR0202
- Report &1 could not be stored.
- RDR0323
- Spooled file can not be processed