The start file SYSPRC.ROBAR-CL.<ver> for ROBAR-CL-DCAM is started via the command /ENTER-PROCEDURE or /CALL-PROCEDURE.
The ROBAR-CL-DCAM parameters are preset in the procedure supplied. They can be adjusted as required. In interactive mode they can also be queried while the procedure is running. In batch mode the parameters must be assigned the correct values in the SYSPRC file in the line where they are defined.
When multiple robot-operated archives are to be controlled, you must copy and adjust the file the requisite number of times (see also the information on the PARTNER and JV-NAME parameters).
Extract from the supplied file SYSPRC.ROBAR-CL.<ver>
/SET-PROC-OPTIONS DATA-ESCAPE-CHAR=STD,LOG-ALLOW=*YES
/"------------------------------------------------------------------------"
/BEGIN-PARAMETER-DECLARATION
/"------------------------------------------------------------------------"
/" UID : userid, where the ROBAR-CL-DCAM program is started "
/DECLARE-PARAMETER NAME=UID(INIT='$SYSMAREN')
/"------------------------------------------------------------------------"
/" PARTNER : name of the DCAM application (8 characters) "
/DECLARE-PARAMETER NAME=PARTNER(INIT='ROBAR1DC')
/"------------------------------------------------------------------------"
/" JV-NAME : job variable "
/DECLARE-PARAMETER NAME=JV-NAME(INIT='*NONE')
/"------------------------------------------------------------------------"
/" UCONID : autorisation name for the UCON connection "
/DECLARE-PARAMETER NAME=UCONID(INIT='CON1')
/"------------------------------------------------------------------------"
/" UCONPWD : UCON password (1-8 characters) or '*NONE' "
/DECLARE-PARAMETER NAME=UCONPWD(INIT='*NONE')
/"------------------------------------------------------------------------"
/" OPEROLE : Operator Role (1-8 characters) or '*NONE' "
/" The routing codes *,T,E,N,G,U and A must be assigned "
/" to OPEROLE. "
/" OPEROLE has no effect if UCONID is not set to *NONE. "
/DECLARE-PARAMETER NAME=OPEROLE(INIT='SYSADM')
/"------------------------------------------------------------------------"
/" OPERID : Operator Identifier (1-8 characters) or '*NONE' "
/" OPERID has no effect if UCONID is not set to *NONE. "
/DECLARE-PARAMETER NAME=OPERID(INIT='TSOS')
/"------------------------------------------------------------------------"
/" OPIDPWD : Operator Id password (1-8 characters) or '*NONE' "
/DECLARE-PARAMETER NAME=OPIDPWD(INIT='*NONE')
/"------------------------------------------------------------------------"
/" TRACE : prefix for trace file name, to which ROBAR adds a "
/" suffix up to 31 characters long. Allowed values: "
/" [:catid:]$userid "
/" or [:catid:][$userid.]composed_name_1..10 "
/DECLARE-PARAMETER NAME=TRACE(INIT='$TSOS.ROBAR')
/"------------------------------------------------------------------------"
/" TRACE-NBR : trace records number pro file. 0=no trace written "
/DECLARE-PARAMETER NAME=TRACE-NBR(INIT='10000')
/"------------------------------------------------------------------------"
/" PRIMARY : PP for primary allocation of trace files "
/DECLARE-PARAMETER NAME=PRIMARY(INIT='60')
/"------------------------------------------------------------------------"
/" SECONDARY : PP for secondary allocation of trace files "
/DECLARE-PARAMETER NAME=SECONDARY(INIT='30')
/"------------------------------------------------------------------------"
/" AUTO-REPLY: '-ar' switch must be removed (' ') when no "
/" self answer function is used (PAUSE messages) "
/DECLARE-PARAMETER NAME=AUTO-REPLY(INIT='-ar')
/"------------------------------------------------------------------------"
/" NO-TYPE : '-nt' to suppress the sending of type "
/" messages at console. Only PAUSE messages are sent. "
/DECLARE-PARAMETER NAME=NO-TYPE(INIT=' ')
/"------------------------------------------------------------------------"
/" MARENLNK : MAREN SYSLNK default pathname, "
/" should always be set to *NONE, "
/" is supported by compatibility reasons. "
/DECLARE-PARAMETER NAME=MARENLNK(INIT='*NONE')
/"------------------------------------------------------------------------"
/" MARENREP : MAREN SYSREP DEFAULT PATHNAME "
/DECLARE-PARAMETER NAME=MARENREP(INIT='*NONE')
/"------------------------------------------------------------------------"
/" MARENPWD : MAREN password (1-8 characters) "
/DECLARE-PARAMETER NAME=MARENPWD(INIT='*NONE')
/"------------------------------------------------------------------------"
/" DUMP : YES = Allow to get a user-dump when needed "
/DECLARE-PARAMETER NAME=DUMP(INIT='YES')
/"------------------------------------------------------------------------"
/DECLARE-PARAMETER NAME=VERSION(INIT='<ver>')
/"------------------------------------------------------------------------"
/DECLARE-PARAMETER NAME=LANGUAGE(INIT='D')
/"------------------------------------------------------------------------"
/END-PARAMETER-DECLARATION
/"------------------------------------------------------------------------"
. . .
Notes
The notes on the parameters of the start file are arranged below in the order of their occurrence.
PARTNER and JV-NAME parameters
When multiple robot archives are supported, the PARTNER parameter and, if the “Job Variables” product is used (see the “JV” manual [7]), the JV-NAME parameter must be unambiguous in all start files.
UCONID, UCONPWD, OPERID, OPEROLE and OPIDPWD parameters
See the explanations in section "ROBAR-CL as an authorized user program".
AUTO-REPLY parameter
The value -ar of the parameter AUTO-REPLY allows ROBAR to answer its own PAUSE messages (autoreply). In this case, it is absolutely necessary that the CONSLOG file be checked for any potential ROBAR problems.
MARENLNK and MARENREP parameters
The initialization of these parameters (*NONE) may not be changed.
ROBAR-CL always selects (e.g. to update the MAREN catalog) the highest installed
MAREN version unless systems support has specified something different by means of the SELECT-PRODUCT-VERSION command.
DUMP parameter
If the parameter DUMP=YES, a dump is created (as in dialog mode) if ROBAR-CL-DCAM terminates abnormally. Otherwise ROBAR-CL-DCAM quits with an error code.
LANGUAGE parameter
The language for the messages output in BS2000/OSD is defined in the ROBAR start file SYSPRC.ROBAR-CL.<ver>. Depending on the language selection, either SYSPAR.ROBAR-CL.<ver>.TEXT.D (German) or SYSPAR.ROBAR-CL.<ver>.TEXT.E (English) is used.