BLSGSCMD Dialog Program - Process an IPCS Subcommand or Command Procedure

Use dialog program BLSGSCMD to cause IPCS to process an IPCS subcommand or CLIST. You must invoke either the BLSGLIBD or the BLSG dialog program to begin an IPCS dialog before you invoke the BLSCSCMD dialog program.

Customizing Use of BLSGSCMD

Use ISPEXEC with the ISPF SELECT service to invoke BLSGSCMD directly, as follows:

ISPEXEC SELECT PGM(BLSGSCMD) PARM(text) [NEWAPPL(BLSG)] PASSLIB

Where text is the subcommand invocation string. ISPF limits text to no more than 100 characters. If your subcommand invocation string may be longer than that limit you may place the string in an ISPF SHARED pool variable and use the following invocation of BLSGSCMD:

ISPEXEC SELECT PGM(BLSGSCMD) PARM(GETVAR) [NEWAPPL (BLSG)] PASSLIB

ISPEXEC SELECT PGM(BLSGSCMD) PARM(GETVAR(var-name)) [NEWAPPL(BLSG)] PASSLIB

When GETVAR is specified alone, BLSGSCMD expects to find the subcommand invocation string in SHARED pool variable BLSSCMDP. Otherwise, you must supply the SHARED pool variable name as var-name.

Use dialog program BLSGSCMD to allow a function other than IPCS to use an IPCS subcommand or CLIST. A selection menu processed by the ISPF SELECT service is a common example of this situation.

You can use dialog program BLSGSCMD when you want any report written to the terminal by the IPCS subcommand or CLIST to be treated as a complete report. BLSGSCMD will discard any report written to the terminal before returning control to the invoker.

Consider an example. Assume that the following ISPF SELECT service request invokes a CLIST.
```
ISPEXEC SELECT CMD('%ISPFPROC')
```
ISPF processes CLIST ISPFPROC. CLIST ISPFPROC can invoke BLSGSCMD multiple times. Each request is a request to write a report to the terminal. Each report will be processed separately, presented as a complete report to the user by IPCS, and discarded when the END primary command is entered. ISPFPROC generates each report separately. ISPFPROC can present selection or data entry panels to the user between each report to determine which report the user desires next.
Contrast the previous example with another. Assume that the following ISPF SELECT service request invokes a CLIST:
```
ISPEXEC SELECT PGM(BLSGSCMD) PARM('%IPCSPROC')
```
IPCS processes CLIST IPCSPROC. CLIST IPCSPROC can invoke many IPCS subcommands, each of which write part of a single report to the terminal. IPCS can process many subcommands within IPCSPROC to satisfy a single DOWN primary command entered on the IPCS dump display reporter panel.
CLIST IPCSPROC can complete a report in two ways:
1. CLIST IPCSPROC can end. Dialog program BLSGSCMD will recognize the end of the report.
2. CLIST IPCSPROC can invoke BLSGSCMD recursively, using a request such as
```
ISPEXEC SELECT PGM(BLSGSCMD) PARM(IEFBR14)
```

Note:

Instead of using ISPEXEC to invoke the ISPF SELECT service, you can use other equivalent means to request the ISPF SELECT service.
The text passed as a parameter to dialog program BLSGSCMD is the subcommand or CLIST invocation to be processed.
Dialog program BLSGSCMD must run under ISPF application identifier BLSG. Specify the ISPF SELECT service option NEWAPPL(BLSG) if another application identifier might be active when the SELECT service is requested.
Specify PASSLIB only if both of the following conditions exist:
1. You also specify NEWAPPL(BLSG).
2. You are running ISPF Version 2 Release 2 or later.

Return Codes

Code	Explanation
00	Successful completion.
other	Return code from the ISPF SELECT service. See z/OS ISPF Dialog Tag Language Guide and Reference for more information.
16	Ending error with two possible meanings: The program invoked BLSG in an inappropriate environment. The ISPF SELECT service generated a return code of 16.