IUCV_CONNECT

NAME

SYNOPSIS

int iucv_connect (__u16 * pathid, __u16 msglim_reqstd, __u8 * user_data, __u8 * userid, __u8 * system_name, int flags1, int * flags1_out, __u16 * msglim, iucv_handle_t handle, void * pgm_data);  

ARGUMENTS

pathid

Path identification number

msglim_reqstd

Number of outstanding messages requested

user_data

16-byte user data

userid

8-byte of user identification

system_name

8-byte identifying the system name

flags1

Specifies options for this path: - IPPRTY (0x20) Specifies if you want to send priority message. - IPRMDATA (0x80) Specifies whether your program can handle a message in the parameter list. - IPQUSCE (0x40) Specifies whether you want to quiesce the path being established. - IPLOCAL (0x01) Allows an application to force the partner to be on the local system. If local is specified then target class cannot be specified.

flags1_out

Pointer to an int. If not NULL, on return the options for

msglim

Pointer to an __u16. If not NULL, on return the maximum number of outstanding messages is stored at the given location.

handle

Address of handler.

pgm_data

Application data to be passed to interrupt handlers.

THE PATH ARE STORED AT THE GIVEN LOCATION

- IPPRTY (0x20) Indicates you may send a priority message.  

DESCRIPTION

This function establishes an IUCV path. Although the connect may complete successfully, you are not able to use the path until you receive an IUCV Connection Complete external interrupt.  

RETURNS

return code from CP, or one of the following - ENOMEM - return code from iucv_declare_buffer - EINVAL - invalid handle passed by application - EINVAL - pathid address is NULL - ENOMEM - pathid table storage allocation failed - return code from internal function add_pathid

Index

NAME

SYNOPSIS

ARGUMENTS

THE PATH ARE STORED AT THE GIVEN LOCATION

DESCRIPTION

RETURNS