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 |