IFAMDSC — Disconnect from an SMF in-memory resource

Description

The IFAMDSC service disconnects from an SMF in-memory resource when the calling program no longer needs to request any more data via the IFAMGET service.

Environment

The requirements for the caller are:

Programming requirements

A prior successful call to the IFAMCON service is required.

Authorization

A prior successful call to the IFAMCON service is required.

Restrictions

The disconnect request must be issued from the same address space as the connect request.

Syntax

Write the call as shown in the following syntax diagram. You must code all parameters on the CALL statement in the order shown.

Call IFAMDSC (
               DscParmBlock,
               rc,
               rsn);

For assembler programming, the stub routine for this callable service resides in SYS1.CSSLIB.

Parameters

The parameters are explained as follows:

DscParmBlock

A disconnect parameter block.

Direction: Input/output

Type: Disconnect parameter block

The disconnect parameter block has the following format and is mapped by the IFAZSYSP macro in SYS1.MACLIB:

Decimal offset	Length	Type	Field	Description
0	4	EBCDIC	ID	ID with value of DSPB
4	2	binary	Length	Total length of the parameter block
6	1	binary	Unused	Unused; must be zero
7	1	binary	Version	Parameter block version number (X'01')
8	16		Token	Token provided by the IFAMCON service

rc

The return code from the service.

Direction: Output

Type: 4-word integer

rsn

The reason code from the service.

Direction: Output

Type: 4-word integer

ABEND codes

IFAMDSC might abnormally end with system completion code X'353'. See z/OS MVS System Codes for an explanation and programmer response.

Related services

Return and reason codes

When the service returns control to the caller, the rc parameter contains a hexadecimal return code and the rsn parameter contains a hexadecimal reason code, as listed in Table 1. The return code and reason code symbols are mapped by the IFARCINM macro.