Messages from the Shared Memory Objects File Server under NDB

This section lists the information and error messages that may be issued when creating or accessing a Shared Memory Objects File Server (FSSM) under Natural for DB2.

For information on the FSSM, see File Server – Shared Memory Object in the Database Management System Interfaces documentation.

Unlike Natural system messages, the explanatory long texts to FSSM messages and codes are only available in this document, not online.

FSSM messages are written into the JESMSGLG data set of the job or started task which tries to access a file server shared memory object. A copy of these messages prefixed by the job name and job number is written into the JESMSGLG of the Natural Authorized Services Manager.

Example:

JESMSGLG of CICS:

17.05.41 S0405196  FSSM008I NATFSSM attached to Shared Memory for
17.05.41 S0405196           CMFSERV2 at address 00000200_06900000

JESMSGLG of Authorized Services Manager SAGAS292:

17.05.41 S0306804  ASM0401 SAGAS292: DAEFCIA2 S0405196 FSSM008I NATFSSM attached to Shared Memory for
17.05.41 S0306804  ASM0401 SAGAS292: DAEFCIA2 S0405196          CMFSERV2 at address 00000200_06900000

Below is information on:

FSSM001E  FSSM004E FSSM007I FSSM010E
FSSM002E FSSM005E FSSM008I FSSM011I
FSSM003E FSSM006E FSSM009E FSSM012I

FSSM001E - NATFSSM invalid function code xx

Explanation The NATFSSM module was called with an invalid function code xx.

Valid function codes are 00, 01, 02, 03 and 04.

Action Specify a subsystem ID of 1 to 4 characters.

FSSM002E - Invalid FSSM parameter card found

Explanation The parameter found in the ASMPARM parameter file starting with the characters FSSM is invalid and will be discarded.
Action Correct the parameter card and restart the Authorized Services Manager. Do not insert blanks into the parameter for FSSM.

FSSM003E - Length of shared memory name wrong

Explanation The length of the name parameter in the parameter card is wrong. It can be 1 to 8 characters.
Action Specify a name of up to 8 character name and restart the Authorized Services Manager.

FSSM004E - Parameter 3, 4, 5 or 6 not lower than 32K

Explanation The value for one of the parameters 3, 4, 5 or 6 has to be between 1 and 32 KB - 1 byte.
Action Correct the specification of these parameters to a value between 1 and 32 KB - 1 byte. Restart the Authorized Services Manager.

FSSM005E - Block size not a multiple of 8

Explanation The specified block size (7th parameter) has to be a multiple of 8.
Action Correct the block size parameter.

FSSM006E - Definition for xxxxxxxx not found

Explanation A request to create a shared memory object with the identifier xxxxxxxx arrived but no definition for xxxxxxxx could be found in the ASMPARM parameter file.
Action Add the definition for xxxxxxxx to the ASMPARM parameter file or change the DDFSERV subparameter of the DB2 profile parameter (NTDB2 macro) to a name defined in the ASMPARM parameter file.

FSSM007I - NATFSSM created shared memory for
                      xxxxxxxx at address xxxxxxxx_xxxxxxxx
                      Number of Directory Entries: nnnnnn
                      Space Map Blocks: nnnnnn
                      Free Space Blocks: nnnnnn
                      ENQUEUE Resource name......: xxxxxxxx

Explanation The NATFSSM module created a shared memory object with the name xxxxxxxx with the virtual address xxxxxxxx_xxxxxxxx. The calling address space is also attached to the shared memory object and can read and write to the memory.
Action None.

FSSM008I - NATFSSM attached to shared memory for
                      xxxxxxxx at address xxxxxxxx_xxxxxxxx

Explanation The NATFSSM module attached the calling address space to the shared memory object with the name xxxxxxxx with the virtual address xxxxxx_xxxxxxxx.
Action None.

FSSM009E - Return code from z/OS service for function xxxxxxxx
                       Reason code yyyyyyyy

Explanation The NATFSSM module received the return code xxxxxxxx from the z/OS service call for the FFSM function with the reason code yyyyyyyy.

For information on the return code xxxxxxxx and reason code yyyyyyyy, see the z/OS service description provided by IBM.

The following z/OS service calls are performed by NATFSSM:

IARV64 SHR IARV64 REQUEST=SHAREMEMOBJ
IARV64 GET IARV64 REQUEST=GETSHARED
IARV64 DTL IARV64 REQUEST=DETACH, AFFINITY=LOCAL
IARV64 DTS IARV64 REQUEST=DETACH, AFFINITY=SYSTEM
IARV64 LIS IARV64 REQUEST=LIST
IEANTCR PR IEANTCR (SCOPE=PRIMARY)
IEANTCR SY IEANTCR (SCOPE=SYSTEM)
IEANTDL PR IEANTDL (SCOPE=PRIMARY)
IEANTDL SY IEANTDL (SCOPE=SYSTEM)

The following functions are provided by NATFSSM:

ATTACH
CREATE
DETACH
DELETE
LIST
Action Contact Software AG support.

FSSM010E - Total number of user blocks (tttttt) is greater
                       than total number of free blocks (ffffff)

Explanation The specified maximum user blocks (6th parameter) is greater than the number of free blocks (2nd parameter minus space map blocks minus directory blocks) in the Shared Memory Objects File Server (FSSM).
Action Increase the number of blocks (2nd parameter) or decrease the maximum number of user blocks (6th parameter).

FSSM011I - NATFSSM detached from shared memory for
                      xxxxxxxx at address xxxxxxxx_xxxxxxxx

Explanation The NATFSSM module detached the calling address space from the shared memory object with the name xxxxxxxx with the virtual address xxxxxx_xxxxxxxx.
Action None.

FSSM012I - NATFSSM deleted shared memory for
                      xxxxxxxx at address xxxxxxxx_xxxxxxxx

Explanation The NATFSSM module deleted the shared memory object with the name xxxxxxxx with the virtual address xxxxxx_xxxxxxxx.
Action None.