Parameter Mask for DO-Procedures in Connections

If a connection is opened on the same host computer, and under the same user-id as the CFS basic task, the following additional services are offered for DO commands:

The DO procedure parameters are checked for completeness. If any parameter defined in the PROC statement has not been assigned a value - either predefined in the PROC statement or in the DO command itself - a parameter mask will be displayed by CFS. All parameters defined in the PROC statement will appear in the parameter mask, together with any respective values. The parameters thus displayed can be entered or modified for that procedure run.

The parameter mask can also be sent without filling it in completely. In this case, the empty parameters have no value assigned to them and they will be requested in BS2000 by prompting.

For a quick check on what parameters are used by a DO procedure, a DO command can be entered in the following form: DO procedure,?

Notes:

The parameter mask for DO procedures can be provided under certain conditions even when the subtask has not been opened under the same userid. The prerequisite for this is that the DO procedure, or LMS library containg it, is accessible to the basic CFS task.

The parameter mask is not displayed if the procedure is stored as a temporary file.

To analyse the PROC statement of the DO procedure, CFS has to open the DO procedure in Read Mode. If the procedure or LMS library is protected with a READ password, CFS will ask for it.

The BS2000 DO Procedure that was last executed can be reactivated with the previous parameters by the command DO_< DUE1. The effect of the input DO, followed by a blank and End Marker wil be to redisplay the last entered DO parameter mask from any connection.

The parameters entered in the parameter mask can be saved in a file CFS.JRSAVE [.jobname] by means of the command SP %name. It can also be saved to a file allocated as follows: /FILE file, LINK=JRSAVE. The exact rule by which the JRSAVE file is named is described in Chapter 27 "Files created by CFS" (CFS.JRSAVE). The JRSAVE file name can also be given explicitly after %name: SP %name,jrsave. %name stands for any 1- to 44-character mnemonic.

A DO command saved with parameters under %name can be reactivated by the BS2000 command DO  %name, or DO %name,jrsave. Further information on the subject "Saving DO Parameters" can be found on page 11-.

The automatic check of DO parameters, and the parameter mask option can be suppressed using the command NDP (No Do-Parameters), or by issuing the DO command with a leading slash i.e. /DO proc.