Start SDA (STRSDA)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The CL command STRSDA is the primary command for the IBM Screen Design Aid (SDA) utility. This command can be invoked in all three environments of the system.

Error messages for STRSDA

*ESCAPE Messages

SDA0001
SDA does not support a &1 workstation.
SDA0002
SDA cannot access its display file.
SDA0003
SDA ended because of a serious error.
SDA0004
Error while processing the STRSDA command.
SDA0005
SDA cannot access its panel group.
SDA0601
SDA is already active.
Top

Parameters

Keyword Description Choices Notes
OPTION SDA option *SELECT, 1, 2, 3 Optional, Positional 1
SRCFILE Source file Qualified object name Optional, Positional 2
Qualifier 1: Source file Name, *PRV
Qualifier 2: Library Name, *PRV, *LIBL, *CURLIB
SRCMBR Source member Name, *PRV, *SELECT Optional, Positional 3
OBJLIB Object library Name, *PRV, *CURLIB Optional
JOBD Job description Qualified object name Optional
Qualifier 1: Job description Name, *PRV, *USRPRF
Qualifier 2: Library Name, *PRV, *LIBL, *CURLIB
TSTFILE Test file Qualified object name Optional
Qualifier 1: Test file Name, *PRV
Qualifier 2: Library Name, *PRV, *LIBL, *CURLIB
MODE Mode *STD, *S38, *S36 Optional
Top

SDA option (OPTION)

Specifies which option to use as a value for the SDA main menu. This parameter is ignored if MODE (*S36) is specified.

The possible values are:

*SELECT
Displays the SDA main menu.
main-menu-option-number
Type a number between 1 and 3 that corresponds to an option on the SDA main menu. If you select this parameter value, the SDA main menu will not appear.
Top

Source file (SRCFILE)

Specifies the name of the source file that contains the source member to be updated or to which a new source member will be added. Only the library qualifier will be used if MODE (*S36) is specified.

The possible values are:

*PRV
Specifies that SDA is to use the name of the source file and library used in your last SDA session (only when MODE is (*STD)).
qualified-source-name
Type the qualified name of an existing source file to be used by SDA. If *CURLIB is specified as the library qualifier, the current library entry of the library list will be searched. If no current library exists in the library list, then library QGPL will be searched. If *LIBL is specified as the library qualifier, *LIBL is used to find the file.
Top

Source member (SRCMBR)

Specifies the name of a new or existing source file member that contains or will contain source for the displays or menus to be updated or created by SDA.

The possible value is:

*PRV
Specifies that SDA is to use the name of the source member used in your last SDA session (only when MODE is (*STD)).
*SELECT
Specifies that SDA will bring up the Design Screens display. From this display you can press F4 on the Member field to see a list of source members to select from.
source-member-name
Type the name of the source member to be created or updated.
Top

Object library (OBJLIB)

Specifies the name of the library into which the program or display file that SDA creates will be stored.

The possible values are:

*PRV
Specifies that SDA is to use the name of the object library used in your last SDA session (only when MODE is (*STD)).
*CURLIB
Specifies that SDA is to use the current library entry of the library list. If no current library entry exists in the library list, then library QGPL will be used.
object-library-name
Type the name of the library into which objects created by SDA are to be stored.
Top

Job description (JOBD)

Specifies the qualified name of the job description to be used with batch jobs being submitted by SDA. This parameter is not used if MODE (*S36) is used.

The possible values are:

*PRV
Specifies that SDA is to use the name of the job description and library used in your last SDA session (only when MODE is (*STD)).
job-description-name
Type the qualified name of the job description to be used with submitted jobs. If *CURLIB is specified as the library qualifier, the current library entry of the library list will be searched. If no current library exists in the library list, then library QGPL will be searched. If *LIBL is specified as the library qualifier, *LIBL is used to find the file.
*USRPRF
Specifies that SDA is to use the name of the job description defined in the user profile.
Top

Test file (TSTFILE)

Specifies the qualified name of the display file to be used for testing. This parameter is ignored if MODE (*S36) is specified.

The possible values are:

*PRV
Specifies that SDA is to use the name of the display file and library used in your last SDA session (only when MODE is (*STD)).
test-file-name
Type the qualified name of the display file to be used for testing. If *CURLIB is specified as the library qualifier, the current library entry of the library list will be searched. If no current library exists in the library list, then library QGPL will be searched. If *LIBL is specified as the library qualifier, *LIBL is used to find the file.
Top

Mode (MODE)

Specifies which version of SDA is to use.

The possible values are:

*STD
Specifies SDA and displays the SDA main menu. The main menu will not appear if the OPTION parameter is specified.
*S36
Specifies the System/36 environment of SDA and displays the System/36 SDA main menu.
*S38
Specifies the System/38 view of SDA and displays the System/38 SDA main menu. The main menu will not appear if the OPTION parameter is specified.
Top

Examples

None
Top

Error messages

*ESCAPE Messages

SDA0001
SDA does not support a &1 workstation.
SDA0002
SDA cannot access its display file.
SDA0003
SDA ended because of a serious error.
SDA0004
Error while processing the STRSDA command.
SDA0005
SDA cannot access its panel group.
SDA0601
SDA is already active.
Top