User`s guide

66 DC 900-1406E

BSCTRAN Programmer’s Guide

that follows. For link conﬁguration, the data block consists of a vari-

able number of two-word conﬁguration parameter/value pairs. For

autodial, the data block contains the NULL-terminated autodial com-

mand string, ﬁlled in as bytes. The data structure is deﬁned by the fol-

lowing C typedef (refer to the

BSCTRAN.INC include ﬁle):

typedef struct { /* Link configuration */

short size ; /* Size of conf_block in bytes */

struct {

short par ; /* Parameter number */

short value ; /* Parameter value */

} conf_block[CNPARTOT];

} LCONF;

start This is a pointer to an integer. It is a longword containing a flag. If the

ﬂag is greater than zero, the ICP link is sent a start (enable) command.

If the ﬂag is set to

SFC_LOCKSTART (52), the link is started and stays

enabled until a stop (disable) command is sent, even if the disable is

not sent by the current process (also see the caution in Chapter 6). If

lconf has a link configuration data block (that is, the size field is non-

zero), a conﬁguration command is sent to the ICP prior to the start

command. If the ﬂag is zero, a stop (disable) command is sent.

Return Codes

See Table 5–2 on page 95 for full descriptions of the error return codes.

Success RCOK

Warning RCSTARTED — The link was previously started with the lockstart

option and has not been disabled.

Failure RCFAIL, RCTO, RCQ_WWR, RCQ_RDTO

Failure codes from BSCDAS, BSCASL