SELECT

The SELECT instruction selects a resource. If the resource is not suffixed with COM, all segments will be selected and printed; otherwise only the common segment will be processed.

Whereas LIST retrieves all resources, SELECT retrieves only the selected resource. You have to identify the key of the selected resource, you cannot use generic keys. The list below, gives the resources retrieved by SELECT action.

The SELECT action also gives to you AD and OI in batch loader format (options BL=Y and BLPRT=Y). From keys created by a list action (options BL=Y and BLPRT=N), we can define SELECT instructions for AD and/or OI and send them like SYSIN to the Batch Command Interface tool.

The resources authorized by the SELECT action are as follows:

AD/ADCOM: Application description
CL/CLCOM: Calendars
CPCOND/CPCONDCO: Current plan condition
CPOC: Current plan occurrences
CPOP/CPOPCOM: Current plan operations
CPST: Current plan status
CPWS/CPWSCOM: Current plan workstations
JCLPREP: Promptable variables setup to current plan
JCLPREPA: Automatic variables setup to current plan
JCLV/JCLVCOM: JCL variable table
JS/JSCOM: JCL segment
LTOC/LTOCCOM: Long-term plan (LTP) occurrences
OI/OICOM: Operator instructions
PR/PRCOM: Periods (period table)
WS/WSCOM: Workstations (workstation table)

SELECT AD

Select an application description.

ACTION=SELECT,RESOURCE=AD, STATUS=adstatus,
                           ADID=application_description,
                           GROUP=authority_group_name,
                           OWNER=owner,
                           PRIORITY=priority,
                           VALFROM=valid_from_date,
                           VALTO=valid_to_date;

adstatus: Status: A or P (char(1))
application_description: Character (char(16))
authority_group_name: Character (char(8))
owner: Character (char(16))
priority: One integer (integer(4))
valid_from_date: Date (YYMMDD)
valid_to_date: Date (YYMMDD)

Note:

The result is created in the referenced file with:

SYSPRINT(LRECL=132): If OPTIONS BL=N (detailed format)
BATCHL (LRECL=80): If OPTIONS BL=Y and BLPRT=Y(BATCH LOADER format)

SELECT CL

List a calendar.

ACTION=SELECT,RESOURCE=CL,CALENDAR=calendar;

calendar: Character (char(16))

SELECT CPCOND

List a current plan condition.

ACTION=LIST,RESOURCE=CPCOND,ADID=application_description,
                          IA=input_arrival_datetime,
                          OPNO=operation_number,
                          CONDID=condition_ID,
                          CONDVAL=condition_status;

application_description: Character (char(16)) can be generic (%*)
input_arrival_datetime: Date and time: YYMMDDHHMM
operation_number: Integer (integer(4))
condition_ID: Integer (integer(3))
condion_status: U, T, or F (char(1))

Specify the complete condition key that is the following operands: ADID, IA, OPNO, and CONDID.

SELECT CPOC

List a current plan occurrence.

ACTION=SELECT,RESOURCE=CPOC,ADID=application_description,
                            GROUP=authority_group_name,
                            GROUPDEF=group_definition,
                            IA=input_arrival_datetime,
                            MCPADDED=mcp_added,
                            MONITOR=externally_monitored,
                            STATUS=oc_status,
                            OWNER=owner, 
                            PRIORITY=priority,
                            RERUN=rerun;

application_description: Character (char(16)
authority_group_name: Character (char(8))
externally_monitored: Y or N (char(1))
group_definition: Character(char(16))
input_arrival_datetime: Date and time: YYMMDDHHMM
mcp_added: Y or N (char(1))
oc_status: The Tivoli Workload Scheduler for z/OS status code: C, D, E, P, S, U, or W (char(1))
owner: Character (char(16))
priority: One integer (integer(4))
rerun: Y or N (char(1))

Note:

The result is created in the referenced file by:

SYSPRINT(LRECL=132): If OPTIONS BL=N (detailed format)
CPOC (LRECL=80): If OPTIONS BL=Y (ADID,IA,STATUS)

SELECT CPOP

List an operation of current plan occurrence.

ACTION=SELECT,RESOURCE=CPOP,ADID=application_description,
                                   CONDRJOB=conditional_recovery_job,
                                   CSCRIPT=centralized_script,
                                   DPREM=removable_by_DP,
                                   ERRCODE=error_code,
                                   EXTNAME=extended_name,
                                   EXTSE=scheduling_environment_name,
                                   GROUP=authority_group_name
                                   IA=input_arrival_datetime,
                                   JOBNAME=jobname,
                                   MATCHTYP=match_type,
                                   MONITOR=externally_monitored,
                                   OPNO=operation_number,
                                   OWNER=owner,
                                   PRIORITY=priority,
                                   SHADOWJ=|shadow_job,
                                   STATUS=oc_status,
                                   UNEXPRC=unexpected_rc
                                   WAITFORW=started_on_WAIT_workstation,
                                   WAITSE=waiting_for_SE,
                                   WSNAME=workstation_name;

application_description: Character (char(16))
authority_group_name: Character (char(8))
conditional_recovery_job: Y or N (char(1))
centralized_script: Y or N(char(1))
removable_by_DP: Y or N (char(1))
error_code: Character (char(4))
extended_name: Character (char(54))
scheduling_environment_name: Character (char(16))
externally_monitored: Y or N(char(1))
input_arrival_datetime: Date and time (YYMMDDHHMM)
jobname: Character (char(8))
match_type: Character (char(3))
op_status: *, A, R, S, C, D, I, E, W, or U (char(1))
operation_number: Integer (integer(4))
owner: Character (char(16))
priority: One integer (integer(4))
|shadow_job: |Y or N (char(1))
started_on_WAIT_workstation: Y or N (char(1))
unexpected_rc: Y or N (char(1))
waiting_for_SE: Y or N (char(1))
workstation_name: Character (char(4))

Note:

There is only one value accepted for MATCHTYP: EXA. If MATCHTYP=EXA is specified, STATUS=* will be interpreted as a normal character instead of as a generic matching character.

Note:

The result is created in the referenced file by:

SYSPRINT(LRECL=132): If OPTIONS BL=N (detailed format)
CPOP (LRECL=80): If OPTIONS BL=Y (ADID,IA,OPNO,STATUS, JOBNAME)

SELECT CPST

List the current plan status.

ACTION=SELECT,RESOURCE=CPST

SELECT CPWS

List a current plan workstation.

|ACTION=SELECT,RESOURCE=CPWS,WSAUTO=automation_workstation,
|                            WSNAME=workstation_name,
|                            WSTYPE=workstation_type,
|                            WSREP=workstation_rep_attri,
|                            WSTWS=fault_tolerant_workstation,
|                            WSVIRT=virtual_workstation,
|                            WSWAIT=wait_workstation,
|                            WSZCENTR=z-centric_workstation
|                            WSRETYPE=|remotengine_workstation|;

automation_workstation: Y or N (char(1))
fault_tolerant_workstation: Y or N (char(1))
|remote-engine_workstation: |Z or D (char(1))
virtual_workstation: Y or N (char(1))
wait_workstation: Y or N (char(1))
workstation_name: Character (char(4))
workstation_rep_attri: A, S, C, or N (char(1))
|workstation_type: |C, G, R, or P (char(1))
|z-centric_workstation: |Y or N (char(1))

At least one of the operands starting with WS must be specified.

SELECT CPWSV

List a current plan virtual workstation.

ACTION=SELECT,RESOURCE=CPWSV,WSNAME=workstation_name,
                             WSDEST=workstation_destination;

workstation_name: Character (char(4))
workstation_destination: Character (char(8)). To indicate a local destination, specify ********

Specify the complete workstation key that is both the operands.

SELECT JCLPREP

List a JCLPREP of an operation.

ACTION=SELECT,RESOURCE=JCLPREP,ADID=application_description,
                               IA=input_arrival_datetime,
                               OPNO=operation_number;

application_description: Character (char(16))
input_arrival_datetime: Date and time (YYMMDDHHMM)
operation_number: Integer (integer(4))

SELECT JCLPREPA

List a JCLPREPA of an operation.

ACTION=SELECT,RESOURCE=JCLPREPA,ADID=application_description,
                                IA=input_arrival_datetime,
                                OPNO=operation_number;

application_description: Character (char(16))
input_arrival_datetime: Date and time (YYMMDDHHMM)
operation_number: Integer (integer(4))

SELECT JCLV

List a variable table.

ACTION=SELECT,RESOURCE=JCLV,JCLVTAB=jcl_variable_table_id;

jcl_variable_table_id: Character (char(16)) can be generic (%*)

SELECT JS

List JCL of an operation.

ACTION=SELECT,RESOURCE=JS,ADID=application_description,
                          IA=input_arrival_datetime,
                          JOBNAME=jobname,
                          OPNO=operation number,
                          WSNAME=workstation_name;

application_description: Character (char(16))
input_arrival_datetime: Date and time (YYMMDDHHMM)
jobname: Character (char(8))
operation_number: Integer (integer(4))
workstation_name: Character (char(4)) can be generic (%*)

SELECT LTOC

List a long-term plan occurrence.

ACTION=SELECT,RESOURCE=LTOC,ADID=application_description,
                            GROUP=authority_group_name,
                            IAD=input_arrival_date,
                            IAT=input_arrival_time,
                            OWNER=owner;

application_description: Character (char(16))
authority_group_name: Character (char(8))
input_arrival_date: Date (YYMMDD)
input_arrival_time: Time (HHMM)
owner: Character (char(16))

SELECT OI

List operator instructions of an operation.

ACTION=SELECT,RESOURCE=OI,ADID=application_description,
                          OPNO=operation_number, 
                          VALTO=valid_to_date;

application_description: Character (char(16))
operation_number: Integer (integer(4))
valid_to_date: date (YYMMDDHHMM)

Notes:

VALTO is an optional operand, which must be specified if more than one temporary OI satisfies the other operands and must not be specified if the request is issued for a permanent OI.
The result is created in the referenced files by:

SYSPRINT(LRECL=132)

If OPTIONS BL=N (detailed result)

BATCHL(LRECL=80)

If OPTIONS BL=Y and BLPRT=Y (BATCH LOADER format)

SELECT PR

List a period.

ACTION=SELECT,RESOURCE=PR,PERIOD=period_name,
                          PRTYPE=period_type;

period_name: Character (char(8))
period_type: A,W,N (char(1))

SELECT WS

List a workstation.

ACTION=SELECT,RESOURCE=WS,WSAUTO=automation_workstation,
                          WSNAME=workstation_name,
                          WSTYPE=workstation_type,
                          WSREP=workstation_rep_att,
                          WSTWS=fault_tolerant_workstation,
                          WSVIRT=virtual_workstation,
                          WSWAIT=wait_workstation,
                          WSZCENTR=z-centric_workstation;
                          WSRETYPE=|remotengine_workstation;

automation_workstation: Y or N (char(1))
fault_tolerant_workstation: Y or N (char(1))
|remote-engine_workstation: |Z or D (char(1))
virtual_workstation: Y or N (char(1))
wait_workstation: Y or N (char(1))
workstation_name: Character (char(4))
workstation_rep_attri: A, S, C, or N (char(1))
|workstation_type: |C, G, R, or P (char(1))
|z-centric_workstation: |Y or N (char(1))

Notes:

At least one of the operands starting with WS must be specified.
|If you specify WSNAME, this setting supersedes all the |other arguments.

SELECT WSV

List a virtual workstation.

ACTION=SELECT,RESOURCE=WSV,WSNAME=workstation_name,
                           WSDEST=workstation_destination;

workstation_name: Character (char(4))
workstation_destination: Character (char(8))

Specify the complete workstation key that is both the operands.

Return codes

0: Instruction successfully processed
4: Resource not found or user ID has no RACF® authorization
8: Instruction failed and an error message is written to the EQQMLOG file
>8: Refer to Return codes.