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.