OpenFrame Open Frame V7.0 Error Message Reference Guide V2.1.1 En

User Manual:

Open the PDF directly: View PDF .
Page Count: 280

Download
Open PDF In Browser	View PDF

OpenFrame
Error Message Reference
Guide
OpenFrame/Base v7.0, Batch v7.0, OSC v7.0, TACF v7.0

Copyright Notice
Copyright © 2015 TmaxSoft Co., Ltd. All Rights Reserved.
5, Hwangsaeul-ro 329beon-gil, Bundang-gu, Seongnam-si, Gyeonggi-do, Korea

Restricted Rights Legend
All TmaxSoft Software (Tmax OpenFrame®) and documents are protected by copyright laws and
international convention. TmaxSoft software and documents are made available under the terms of the
TmaxSoft License Agreement and may only be used or copied in accordance with the terms of this
agreement. No part of this document may be transmitted, copied, deployed, or reproduced in any form
or by any means, electronic, mechanical, or optical, without the prior written consent of TmaxSoft Co.,
Ltd.
Nothing in this software document and agreement constitutes a transfer of intellectual property rights
regardless of whether or not such rights are registered) or any rights to TmaxSoft trademarks, logos, or
any other brand features.
This document is for information purposes only.The company assumes no direct or indirect responsibilities
for the contents of this document, and does not guarantee that the information contained in this document
satisfies certain legal or commercial conditions.
The information contained in this document is subject to change without prior notice due to product
upgrades or updates. The company assumes no liability for any errors in this document.

Trademarks
Tmax® and Tmax OpenFrame® are a registered trademark of TmaxSoft Co., Ltd. Other products, titles
or services may be registered trademarks of their respective companies.

Open Source Software Notice
Document Information
Document Name: OpenFrame Error Message Reference Guide
Document Created: 2015-07-21
Software Version: OpenFrame/Base v7.0, Batch v7.0, OSC v7.0, TACF v7.0
Document Version: v2.1.1

Table of Contents
About This Document .................................................................................................... v
Chapter 1.

Error Code Base ........................................................................................ 1

1.1.

Discrete Modules ........................................................................................... 1

1.2.

Collective Modules ......................................................................................... 2

Chapter 2.

Discrete Modules ...................................................................................... 3

2.1.

Non-VSAM (-0) .............................................................................................. 3

2.2.

TSAM (-1000) ............................................................................................. 11

2.3.

DSIO (-2000) ............................................................................................... 24

2.4.

ICF (-3000) .................................................................................................. 33

2.5.

AMS (-4000) ................................................................................................ 38

2.6.

DSALC (-5000) ............................................................................................ 44

2.7.

VOLM (-6000) .............................................................................................. 61

2.8.

LOCKM (-7000) ........................................................................................... 68

2.9.

PGMDD (-8000) ........................................................................................... 75

2.10.

TJES (-9000) .............................................................................................. 77

2.11.

AMSX (-10000) .......................................................................................... 89

2.12.

SMS (-11000) ............................................................................................ 93

2.13.

DSCOM (-12000) ....................................................................................... 96

2.14.

SPOOL (-13000) ........................................................................................ 99

2.15.

CPMLIB (-15000) ..................................................................................... 102

2.16.

MVSSYS (-16000) .................................................................................... 104

2.17.

SAF (-17000) ........................................................................................... 105

2.18.

TACF (-18000) .......................................................................................... 114

2.19.

HiDB (-20000) .......................................................................................... 122

2.20.

OFCOM (-22000) ..................................................................................... 137

2.21.

SAFX (-23000) ......................................................................................... 145

2.22.

SAFO (-24000) ......................................................................................... 147

2.23.

SAF BAT (-26000) .................................................................................... 147

2.24.

MEMM (-27000) ....................................................................................... 148

2.25.

TLIC (-28000) ........................................................................................... 150

2.26.

TTREE (-29000) ....................................................................................... 152

2.27.

IMS (-30000) ............................................................................................ 154

2.28.

SVRCOM (-32000) ................................................................................... 160

2.29.

OUTQ (-33000) ........................................................................................ 166

2.30.

CONSOLE (-34000) ................................................................................. 169

2.31.

SPIO (-36000) .......................................................................................... 174

2.32.

SMF (-93000) ........................................................................................... 177

Chapter 3.

Collective Modules ................................................................................ 181

3.1.

OSCSVR (-57000) ...................................................................................... 181

OpenFrame iii

3.2.

OSC (-50000) ............................................................................................ 192

Index .......................................................................................................................... 253

iv OpenFrame Error Message Reference Guide

About This Document

Intended Audience
This document is intended for programmers and system engineers who intend to work with
OpenFrame. It describes errors that may occur in Tmax OpenFrame

and how to handle such

errors.

Required Knowledge
There is no knowledge that is required to understand this document.

Document Scope
This guide lists and describes the error codes for nearly all of the supported modules in TmaxSoft
OpenFrame. However, it does not contain the errors from OFAdmin which provides the GUI
interface for OpenFrame/OSC and OpenFrame/Batch .

About This Document v

Document Organization
This document consists of three chapters:
● Chapter 1: Error Code Base
A basic table of contents. This chapter lists and describes the different discrete and collective
modules and then provides the range of error code numbers associated with them.
● Chapter 2: Discrete Modules
Provides information about errors that occur in the discrete modules and suggests corrective
actions.
● Chapter 3: Collective Modules
Provides information about errors that occur in the collective modules and suggests corrective
actions.

vi OpenFrame Error Message Reference Guide

Conventions
Convention

Meaning

Program source code file name, directory

Press Ctrl and C simultaneously

[Button]

GUI button or menu name

Bold

Emphasis

" "(Double quotations)

Reference to a related guide, or a chapter or section within the guide

'Input'

Input field in screen UI

Hyperlink

E-mail account, website, reference to other chapters or sections

Proceeding order of menu

+----

Directories or files exist below this directory

|----

Directories or files do not exist below this directory
Note

Reference or caution

[Figure 1.1]

Figure caption

[Table 1.1]

Table caption

About This Document vii

Related Documents
Guide

Description

OpenFrame

Describes how to manage Batch JOBs in OpenFrame systems.

TJES Guide
OpenFrame

Describes overall features of OpenFrame/Batch.

Batch Guide
OpenFrame

Describes overall features of OpenFrame/Base.

Base Guide
OpenFrame
Dataset Guide
OpenFrame

Introduces OpenFrame datasets and describes the different types of
datasets and cataloging methods.

Describes information necessary for the OSC system administration.

OSC Administrator's
Guide
Tibero TSAM Guide

Introduces TSAM as a VSAM equivalent solution. Includes descriptions
regarding TSAM dataset types, dataset management, and dataset
processing methods.

References
Product

Guides

Tmax

Administration Guide
Error Message Reference
FDL Reference Manual

Oracle

Error Message Reference

viii OpenFrame Error Message Reference Guide

Contact Information
Korea
TmaxSoft Co., Ltd.
5, Hwangsaeul-ro 329beon-gil, Bundang-gu,
Seongnam-si, Gyeonggi-do, 463-824
South Korea
Tel: +82-31-8018-1000
Fax: +82-31-8018-1115
Email: info@tmax.co.kr
Web (Korean): http://www.tmaxsoft.com
TechNet: http://technet.tmaxsoft.com

USA
TmaxSoft Inc.
101 N. Wacker Drive Suite 2014,
Chicago, IL 60606
U.S.A
Tel: +1-312-525-8330
Email: info@tmaxsoft.com
Web (English): http://us.tmaxsoft.com

Japan
TmaxSoft Japan Co., Ltd.
5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073
Japan
Tel: +81-3-5765-2550
Fax: +81-3-5765-2567
Email: info@tmaxsoft.co.jp
Web (Japanese): http://www.tmaxsoft.co.jp

About This Document ix

China
Beijing TmaxSoft System Software Co., Ltd.
Room103, No.2 Huizhong Building, Seven Street Shangdi,
Haidian District, Beijing, 100085
P.R.China
Tel: +86-10-6298-8827
Email: info@tmaxsoft.com.cn
Web (Chinese): http://cn.tmaxsoft.com

Brazil
Tmax Brasil Sistemas e Serviços Ltda.
Av. Copacabana, 177, sala 32~35 Empresarial 18 do Fortel
Alphaville Barueri, Sao Paulo, 06472-001
Brazil
Tel: +55-11-4191-3100
Fax: +55(11) 4191-3705 (extension#112)
Email: info.bra@tmaxsoft.com
Web (Portuguese): http://br.tmaxsoft.com

Russia
Tmax Rus L.L.C.
Grand Setun Plaza, No A204 Gorbunova st.2,
Moscow, 121596
Russia
Tel: +7(495)970-01-35
Email: info.rus@tmaxsoft.com
Web (Russian): http://ru.tmaxsoft.com

x OpenFrame Error Message Reference Guide

Singapore
Tmax Singapore Pte. Ltd.
430 Lorong 6, Toa Payoh #10-02,
OrangeTee Building, 319402
Singapore
Tel: +65-6259-7223
Fax: +65-6258-7112
Email: info.sg@tmaxsoft.com
Web (English): http://www.tmaxsoft.com

United Kingdom
TmaxSoft UK Ltd.
(Kingston Office) Surrey House, Suite 221, 34 Eden Street,
Kingston-Upon-Thames, KT1 1ER
(Canary Wharf Office) Level39, 1 Canada Square, Canary Wharf, E14 5AB
United Kingdom
Tel: +44-(0)20-8481-3776, +44(0)203-668-3628
Fax: +44-203-092-4681
Email: info.uk@tmaxsoft.com
Web (English): http://www.tmaxsoft.com

About This Document xi

Chapter 1. Error Code Base

1.1. Discrete Modules
Error code base Module name

Module description

-0

This module manages non-VSAM datasets and handles

Non-VSAM

I/O.
-1000

TSAM

This module manages VSAM datasets and handles I/O.

-2000

DSIO

This module provides standardized interfaces for all
datasets.

-3000

ICF

This module provides an integrated catalog function.

-4000

AMS

This module manages creation and deletion of datasets
and manages catalog functions.

-5000

DSALC

This module handles allocations for datasets.

-6000

VOLM

This module shows information for volumes and
manages VTOC.

-7000

LOCKM

Lock server client module.

-8000

PGMDD

This module searches the allocated dataset by DD
name.

-9000

TJES

This module manages batch jobs.

-10000

AMSX

This module manages datasets including dataset
allocations.

-11000

SMS

This module provides functions such as SMS and ACS.

-12000

DSCOM

This is the dataset common library module.

-13000

SPOOL

This module manages the
creation/deletion/backup/restoration of SPOOL datasets.

-15000

CPMLIB

This module manages code page conversions.

-16000

MVSSYS

This module handles JES commands.

-17000

SAF

This module manages OpenFrame system security.

-18000

TACF

This module manages user authentication and resource
access control.

Chapter 1. Error Code Base 1

Error code base Module name

Module description

-20000

This is the hierarchical database that replaces the

HiDB

mainframe IMS/DB or ADM/DB within the new open
environment system.
-22000

OFCOM

This is the OpenFrame common library module.

-23000

SAFX

This module provides an interface between SAF, the
OpenFrame system security module, and the
authentication server.

-24000

SAFO

This module provides an interface between SAF, the
OpenFrame system security module, and online
products.

-26000

SAF BAT

This module provides an interface between SAF, the
OpenFrame system security module, and Batch.

-27000

MEMM

This module allocates and manages dynamic memory.

-28000

TLIC

This module checks OpenFrame licenses.

-29000

TTREE

This module uses a tree structure to manage memory.

-30000

IMS

This module manages control blocks in HiDB.

-32000

SVRCOM

This is the Tmax Server common library module.

-33000

OUTQ

This module manages output queues.

-34000

CONSOLE

This module provides OpenFrame console functions.

-36000

SPIO

This module manages SPOOL datasets and handles
I/O.

-93000

SMF

This module manages the SMF log files that record the
ouput of various services.

1.2. Collective Modules
Error code base Module name

Module Description

-50000

OSC

OSC (Online System type C) module.

-57000

OSCSVR

OSC server module.

2 OpenFrame Error Message Reference Guide

Chapter 2. Discrete Modules

2.1. Non-VSAM (-0)
The Non-VSAM module is responsible for managing non-VSAM datasets and I/O to datasets.
This section lists error codes that can occur in the Non-VSAM module, descriptions of the errors
and suggested corrective actions, and in some cases, references for more information.

NVSM_ERR_NOT_FOUND (-301)
Description This error occurs when no records are found that correspond to a given key
value.
Action

Check whether the key value is correctly configured.

NVSM_ERR_END_OF_FILE (-302)
Description This EOF error occurs during sequential reading of a non-VSAM dataset.
Action

Check that valid logic exists for when an application reaches EOF.

NVSM_ERR_MEMORY_ALLOC (-303)
Description A memory allocation failure occurred.
Action

Check whether there is sufficient memory space in the system.

NVSM_ERR_NOT_IMPLEMENTED (-304)
Description This error occurs when trying to use an ISAM that is not supported by OpenFrame
Non-VSAM.
Action

Use VSAM.

Chapter 2. Discrete Modules 3

NVSM_ERR_NOT_ALLOWED (-305)
Description This error occurs when the I/O mode, DSORG, or DEVTYP (device type) is
incorrectly configured for a submitted job.
Action

Check whether I/O mode, DSORG or DEVTYP is correctly configured.

NVSM_ERR_INVALID_REQUEST (-306)
Description This error occurs when an invalid DCB value or mode is configured in Non-VSAM.
Action

Check whether the DCB value or mode is correctly configured.

NVSM_ERR_INVALID_FILELIST (-307)
Description This error occurs when a user attempts to OPEN a dataset and the file structure
list which contains non-VSAM dataset information is not configured.
Action

Specify the file structure list.

NVSM_ERR_INVALID_FILE (-308)
Description This error occurs when a user attempts to CREATE, ERASE, RENAME, or STAT
a dataset and the file structure which includes non-VSAM dataset information is
not specified.
Action

Specify the file structure.

NVSM_ERR_INVALID_DSNAME (-401)
Description This error occurs when a user attempts to RENAME a dataset and a new name
is not assigned for the dataset to be changed.
Action

Rename the dataset to be changed.

NVSM_ERR_INVALID_STAT (-402)
Description This error occurs when a user performs a STAT command for a dataset, but the
structure which contains dataset information is not specified.

4 OpenFrame Error Message Reference Guide

Action

Specify the structure to contain dataset information.

NVSM_ERR_INVALID_FD (-501)
Description This error occurs when the file descriptor specified for non-VSAM dataset is
invalid.
Action

Check whether OPEN is successfully executed on a non-VSAM dataset.

NVSM_ERR_MAX_FILES (-502)
Description This error occurs when exceeding the maximum number of non-VSAM datasets
that can be concurrently opened.
Action

Try to execute OPEN again after closing unused datasets.

NVSM_ERR_INVALID_ADDR (-503)
Description This error occurs when a user attempts to FIND a dataset with an address and
the address value is out of the scope of the BLDL list.
Action

Check whether the address value does not exceed the number of BLDL lists.

NVSM_ERR_MEMBER_NOT_FOUND (-504)
Description This error occurs when a user attempts to FIND a dataset with a member name
and a member starting with the given string is not found.
Action

Check whether the given string used for the member name is correct.

NVSM_ERR_INVALID_BLDL (-505)
Description This error occurs when a user attempts to FIND a dataset with an address and
the BLDL list is not found.
Action

Before executing FIND, check whether the BLDL command has been executed.

Chapter 2. Discrete Modules 5

NVSM_ERR_MEMBER_DUPLICATE (-506)
Description This error occurs when a user performs a STOW command and the member to
be added already exists.
Action

Delete the existing member or change the name of new member to be added.

NVSM_ERR_SMALL_BUFFER_SIZE (-507)
Description This error occurs when the internal buffer size of NVSM is smaller than LRECL.
Action

Increase the size of NVSM_BUFFER_SIZE in ds.conf.

NVSM_ERR_STOW_CHANGE_PARM (-508)
Description This error occurs when a CHANGE command is executed with an invalid
parameter type in a STOW program.
Action

Check whether the parameter type is valid.

NVSM_ERR_INVALID_BUF_SIZE (-601)
Description This error occurs when a user performs a GET (READ) command and the length
of the data buffer is smaller than that of the record.
Action

Modify the length of the data buffer to be at least as long as file's record length.

NVSM_ERR_INVALID_KEY (-602)
Description This error occurs when a user performs a READ or WRITE command using
BDAM and a key parameter is not specified.
Action

Check whether the key parameter is specified.

NVSM_ERR_GET_RDW_FAIL (-603)
Description This error occurs when failing to read RDW (Record Description Word)
information.
Action

Check whether it is a valid variable length dataset.

6 OpenFrame Error Message Reference Guide

NVSM_ERR_PUT_RDW_FAIL (-604)
Description This error occurs when failing to store RDW information.
Action

Check whether there is sufficient space.

NVSM_ERR_PUTX_RECORD_NUM (-605)
Description This error occurs when PUTX (REWRITE) is performed for two or more records.
Action

Check whether there are more than two records to perform PUTX (REWRITE)
on.

NVSM_ERR_NOT_END_WITH_NEWLINE (-606)
Description This error occurs if \n is not found at the end of the record when RECFM is an
L type (Line Sequential) and the specified mode is Move Mode.
Action

Add \n to the end of the record.

NVSM_ERR_LOCATE_FAIL (-607)
Description This internal buffer error occurs while attempting to PUTX (REWRITE).
Action

Contact the TmaxSoft technical support team.

NVSM_ERR_INVALID_GET_RECL (-608)
Description This error occurs when the length of the most recent record read by GET (READ)
is not found.
Action

Check whether GET (READ) has been executed immediately before calling
PUTX (REWRITE).

NVSM_ERR_SIZE_LIMIT_OVER (-609)
Description This error occurs when the current dataset size exceeds the available space.
Action

Check the DCB SPACE information to determine if the program's I/O operation
for the dataset results in an endless loop.

Chapter 2. Discrete Modules 7

NVSM_ERR_PUTX_SIZE (-610)
Description This error occurs when the length of the record to PUTX(REWRITE) to does not
match the length of the last read record.
Action

Make sure the length of the record to PUTX to matches the length of the last
read record.

NVSM_ERR_PUT_MULTIPLE_RECORDS (-611)
Description This error occurs when the record type is L and multiple records are included in
one PUT(WRITE) action.
Action

Write only one record in each action.

NVSM_ERR_WRITE_LEGTH (-612)
Description This error occurs when the record is written with a proper length.
Action

Retry the action.

NVSM_ERR_OUTLIM_OVER (-613)
Description This error occurs when an output that takes place in the spool exceeds the
OUTLIM configuration.
Action

Check the configuration of OUTLIM in tjclrun.conf or JCL.

NVSM_ERR_SYSTEM_CREAT (-900)
Description This error occurs when the creat() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_UNLINK (-901)
Description This error occurs when the unlink() system call fails.
Action

Check the system call error messages displayed in SPOOL.

8 OpenFrame Error Message Reference Guide

NVSM_ERR_SYSTEM_RENAME (-902)
Description This error occurs when the rename() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_OPENDIR (-903)
Description This error occurs when the opendir() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_MKDIR (-904)
Description This error occurs when the mkdir() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_RMDIR (-905)
Description This error occurs when the rmdir() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_ACCESS (-906)
Description This error occurs when the access() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_OPEN (-910)
Description This error occurs when the open() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_READ (-911)
Description This error occurs when the read() system call fails.

Chapter 2. Discrete Modules 9

Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_WRITE (-912)
Description This error occurs when the write() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_LSTAT (-913)
Description This error occurs when the lstat() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_LSEEK (-914)
Description This error occurs when the lseek() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_CLOSE (-915)
Description This error occurs when the close() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_FOPEN (-920)
Description This error occurs when the fopen() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_FREAD (-921)
Description This error occurs when the fread() system call fails.
Action

Check the system call error messages displayed in SPOOL.

10 OpenFrame Error Message Reference Guide

NVSM_ERR_SYSTEM_FWRITE (-922)
Description This error occurs when the fwrite() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_POPEN (-930)
Description This error occurs when the popen() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_PCLOSE (-931)
Description This error occurs when the pclose() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_LOCALTIME (-940)
Description This error occurs when the localtime() system call fails.
Action

Check the system call error messages displayed in SPOOL.

NVSM_ERR_SYSTEM_SIGNAL (-950)
Description This error occurs when the signal() system call fails.
Action

Check the system call error messages displayed in SPOOL.

2.2. TSAM (-1000)
The TSAM module is responsible for managing VSAM datasets and I/O to datasets. This section
lists error codes that can occur in the TSAM module, descriptions of the errors, suggested
corrective actions, and in some cases, references for more information.

Chapter 2. Discrete Modules 11

TSAM_ERR_DUPLICATE_RECORD (-1001)
Description This error occurs when trying to add a record to a KSDS or RRDS dataset and
the record already exists with an identical record identifier.
Action

Handle the error based on the requirements of the application. If necessary,
modify the application logic and the data.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_DUPLICATE_KEY (-1002)
Description This error occurs when there are more records to read sequentially from the
dataset with the same key value, where the key is a non-unique alternate index
path.
Action

Handle the error according to the requirements of the application. If there are
more records with the same alternate key, use the READ NEXT option for a
sequential read. To disregard the records which have the same alternate key,
perform direct access with the READ option after resetting the key.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_NOT_FOUND (-1003)
Description This error occurs when records corresponding to specified record identifier are
not in the dataset.
Action

Handle the error according to the requirements of the application.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_END_OF_FILE (-1004)
Description This error occurs during a sequential read operation when going beyond the end
of the dataset (READ NEXT) or beyond the beginning of the dataset (READ
PREV).
Action

Handle the error according to the requirements of the application.

Reference

Refer to the "Tibero TSAM Guide."

12 OpenFrame Error Message Reference Guide

TSAM_ERR_RECORD_LOCKED (-1005)
Description This error occurs when the record to READ for an UPDATE or REWRITE with
the NOSUSPEND option is already locked by another application.
Action

Check if applications that should not run simultaneously are running
simultaneously, and if being run simultaneously is intended, remove the
NOSUSPEND option and change the application so that the TSAM will wait and
resolve the situation.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_RECORD_BUSY (-1006)
Description This error occurs when a record to READ with the NOSUSPEND option is already
locked by another application.
Action

Remove the NOSUSPEND option and change the application so that the TSAM
will wait and resolve the solution, or try READ again after a few minutes.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_LENGTH_ERROR (-1007)
Description This error occurs when trying to save a record to a fixed length dataset that has
a length different from the fixed record length in the dataset definition (DEFINE)
or when trying to save a record to a variable length dataset that is longer than
the maximum length of the record defined in the dataset definition.
Action

Adjust the record buffer length transmitted to the application's write, or redefine
the dataset definition if the problem is with the dataset definition.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_INVALID_REQUEST (-1008)
Description This error occurs when parameters submitted to use with the TSAM API are not
valid.
Action

Revise the application.

Reference

Refer to the "Tibero TSAM Guide."

Chapter 2. Discrete Modules 13

TSAM_ERR_NOT_ALLOWED (-1009)
Description This error occurs when using actions not approved by the open mode, the mode
for setting the dataset as OPEN. For example, making the dataset OPEN using
Read Only and attempting WRITE.
Action

Revise the application restrict the use of actions that are not approved by open
mode.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_NO_SPACE (-1010)
Description This error occurs when the storage space for a dataset is insufficient.
Action

Check the available table space for the TSAM dataset and available disk space
in the file system.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_MEMORY_ALLOC (-1011)
Description This error occurs when additional applications cannot be executed due to a lack
of memory.
Action

Check if there is a memory leak in the application and if the application mistakenly
requests an invalid memory size (negative value). Check if the memory limit is
too low.

TSAM_ERR_IO_FAILURE (-1012)
Description This error occurs while performing disk I/O.
Action

Contact the system administrator.

TSAM_ERR_INVALID_OPERATION (-1013)
Description This error occurs when trying to perform an action that is not possible due to the
dataset structure. For example, this error occurs when trying to delete a record
from an ESDS type dataset.

14 OpenFrame Error Message Reference Guide

Action

Since the requested operation is not supported in the dataset structure, revise
the application to not use the problematic function call.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_INTERNAL (-1015)
Description This internal TSAM server error usually occurs when table space for storing
TSAM datasets has not been created in the volume, or when the VVDS table
does not exist in the volume. Other internal server errors, with unclassified types,
return this error code.
Action

Create the required table space. If a WDS table does not exist, register the
volume using the voladd tool. When an internal server error with an unclassified
type occurs, contact the TmaxSoft technical support team.

TSAM_ERR_NOT_IMPLEMENTED (-1016)
Description This error occurs when trying to use a function that is currently not supported.
Action

Revise the application to not use the unsupported function. If this solution isn't
possible, contact the TmaxSoft technical support team.

TSAM_ERR_INVALID_CONN_ID (-1101)
Description This error occurs when a connection ID that has not been connected is given to
the TSAM API as a connection ID value.
Action

Revise the application.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_MAX_CONNECTIONS (-1102)
Description This error occurs when the number of tsam_connect() requests exceeds the
maximum number of simultaneous connections.
Action

When the TSAM server's max session number is less than required, increase
the value. Check if the application is creating connections without closing them,
and then revise the application. In order to close an unused connection, use the
tsam_disconnect() function.

Chapter 2. Discrete Modules 15

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_DUPLICATE_CONN_ID (-1103)
Description This error occurs when trying to use a connection ID that has already been
provided to the CONNECT API.
Action

Revise the application.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_TX_STILL_ACTIVE (-1104)
Description This error occurs when a transaction is not terminated by the DISCONNECT
API.
Action

Revise the application.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_CONNECT_FAILURE (-1105)
Description This error occurs when a connection is not possible due to network problems or
TSAM server problems.
Action

Check if the TSAM server has properly booted and is running. Check if the TSAM
server is operating properly and if there is a network problem when connecting
to the host. Check that the host name, IP, or port number of the CONNECT
function's connection parameters are correct. Check if the values (in seconds)
of the TB_CONN_TIMEOUT or TB_READ_TIMEOUT environment variables are
too small.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_AUTHENTICATION_FAILURE (-1106)
Description This error occurs when authentication fails for a username and password given
to the CONNECT API.
Action

Check if the username and password given to the CONNECT function are correct.
Check if the given user exists and if they have the CONNECT permission in the
TSAM server.

16 OpenFrame Error Message Reference Guide

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_INVALID_DATABASE (-1107)
Description This error occurs when database connection information given to the CONNECT
API is incorrect.
Action

Check if the connection information given to the CONNECT API is correct,
especially the database connection string information.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_DISCONNECTED (-1108)
Description This error occurs when a connection to the TSAM server, established through
the CONNECT API, has been lost.
Action

Check if the TSAM server is properly operating and if there's a network problem
connecting to the corresponding host. Check if the values (in seconds) of the
TB_CONN_TIMEOUT or TB_READ_TIMEOUT environment variables are too
small.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_INVALID_TX_ID (-1201)
Description This error occurs when a negative or incorrect value is assigned to txid when
using TSAM tx control variable(s). It can also occur when using TSAM tx control
variables without first calling the CONNECT API.
Action

Check if the application is coded in accordance with the general TSAM API usage
procedure.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_MAX_TRANSACTIONS (-1202)
Description This error occurs when exceeding the maximum txid allowed for a single TSAM
client program.

Chapter 2. Discrete Modules 17

Action

Since only one tx is supported for a connection, this error occurs when too many
connections are used simultaneously. Check if the application continuously calls
the CONNECT API without calling the DISCONNECT API.

Reference

Refer to "Tibero TSAM Guide."

TSAM_ERR_DUPLICATE_TX_ID (-1203)
Description This error occurs when a txid that has not been given to TX END after TX START
is given to TX START again.
Action

Revise the application to ensure that the same txid value is not used.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_TX_STARTED_ALREADY (-1204)
Description This error occurs when a connection initiated by TX START is repeatedly
referenced by TX START.
Action

Revise the application to not repeatedly call TX START with the same connection
ID.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_TX_START_FAILURE (-1205)
Description This error occurs when TX START fails in TSAM server.
Action

Contact the TmaxSoft technical support team.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_TX_COMMIT_FAILURE (-1206)
Description This error occurs when a Transaction Commit fails in TSAM server.
Action

Contact the TmaxSoft technical support team.

Reference

Refer to the "Tibero TSAM Guide."

18 OpenFrame Error Message Reference Guide

TSAM_ERR_TX_ROLLBACK_FAILURE (-1207)
Description This error occurs when a Transaction Rollback fails in TSAM server.
Action

Contact the TmaxSoft technical support team.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_INVALID_FD (-1301)
Description This error occurs when a negative value is assigned to the fd value is used as
a parameter for the OPEN API or functions that follow it, or when using an fd
value that has not been opened.
Action

Check if the application calls functions to perform record I/O on a dataset without
calling the OPEN API. Check if the fd that has been closed is still in use, and
correct it.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_MAX_OPEN_FILES (-1302)
Description This error occurs when the maximum number of tsam_open() calls from a single
TSAM client (1024) is exceeded.
Action

Check if there are cases where the OPEN API is called without the corresponding
CLOSE API in the application, and correct it.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_DUPLICATE_FD (-1303)
Description This error occurs when the OPEN API is called using the same fd as one that
has already been used in another OPEN API without closing it.
Action

Correct the application to not use the same fd to call several OPEN APIs.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_FILE_NOT_FOUND (-1304)
Description This error occurs when a dataset to be used by the OPEN API is not found.
Action

Run the application after the required dataset is defined. (DEFINE CLUSTER)

Chapter 2. Discrete Modules 19

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_VOLUME_NOT_FOUND (-1306)
Description This error occurs when the table space, corresponding to a volume serial that
was passed as a parameter when calling the CREATE API to create a dataset,
is not created on the TSAM server.
Action

Create the table space corresponding to the volume, register it with the voladd
tool, and then run the application software.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_ENTRY_DEFINED_ALREADY (-1317)
Description This error occurs when trying to redefine a TSAM dataset that is already defined
in a configuration without first deleting it.
Action

This can usually be resolved by scheduling batch jobs in an appropriate order.
Alternatively, delete the dataset first before redefining it. Check if the jobs are
running in the correct order.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_DEADLOCK (-1325)
Description This error occurs when detecting a deadlock on the TSAM server.
Action

Change the application logic such that when a deadlock is detected on the TSAM
server so that when a request for a lock fails while already possessing a lock,
unlock all locks and try again. Generally, end the application that received the
DEADLOCK error and restart it.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_INVALID_TOKEN (-1401)
Description This error occurs when the token value given as a parameter to the REWRITE
and UNLOCK API is not returned after being created with the READ FOR
UPDATE API. Alternatively, the returned token value resulting from calling the
READ FOR UPDATE API has been changed due to an application error.

20 OpenFrame Error Message Reference Guide

Action

Check if the returned token value resulting from calling the READ FOR UPDATE
API was changed due to an application error. Check if the READ FOR UPDATE
APIs are repeatedly called in a row without using the UNLOCK API and then
correct it.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_MAX_LOCK_TOKENS (-1402)
Description This error occurs when the maximum number of lock tokens (1024) is exceeded
by performing too many READ FOR UPDATE APIs sequentially without using
the UNLOCK API.
Action

Revise the code responsible for calling the READ FOR UPDATE API multiple
times without first using the UNLOCK API, to avoid exceeding the maximum
possible number of lock tokens.

TSAM_ERR_TX_NOT_STARTED (-1403)
Description This error occurs when using the TSAM record I/O API (READ, WRITE,
REWRITE, DELETE, etc) without having first called the TX START API.
Action

Check if the application is built according to the general TSAM API usage rules.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_KEYLENGTH (-1405)
Description This error occurs when the TSAM API function's keylen value is different from
the key length given when defining a dataset.
Action

Check if the key length value is wrong in the application and correct it. Note that
when setting the GENERIC option, the key length can be given a smaller value
than the one set when defining the dataset. When setting the RBA or RRA option,
the key length is always 4 bytes.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_GENERIC_KEYLENGTH (-1406)
Description This error occurs when a keylen and the GENERIC option conflict (such as by
being the same size or a negative value), because when the TSAM API function's

Chapter 2. Discrete Modules 21

keylen has the GENERIC option, the given keylen must be assigned a smaller
value than the keylen assigned when the dataset was defined.
Action

Remove the GENERIC option from the application or change the keylen value.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_INVALID_REQUEST_ID (-1501)
Description This error occurs when reqid is assigned an out-of-range value when calling the
START BR, END BR, RESET BR, READ NEXT, and READ PREV APIs for the
BROWSE operation or when calling the END BR, RESET BR, READ NEXT, and
READ PREV APIs with a reqid that has not been given to START BR.
Action

Revise the application to assign an appropriate reqid value. The reqid value
assigned when calling the END BR, RESET BR, READ NEXT, and READ PREV
APIs should be the same as the reqid value assigned when calling START BR.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_MAX_REQUEST_IDS (-1502)
Description This error occurs when using more than maximum number of BROWSERs in a
single dataset OPEN call.
Action

Check if application repeatedly performs START BR more times than the limit
(16) without performing END BR, and then correct it.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_DUPLICATE_REQUEST_ID (-1503)
Description This error occurs when a previously created reqid of BROWSE by START BR
is passed on to START BR without first using END BR.
Action

Revise the application to contain both START BR and END BR for a single reqid.

Reference

Refer to the "Tibero TSAM Guide."

TSAM_ERR_ALLOC_RDB_OBJECT (-1901)
Description This error occurs when allocating an RDB object fails.
Action

Refer to the displayed Oracle error message.

22 OpenFrame Error Message Reference Guide

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_FREE_RDB_OBJECT (-1902)
Description This error occurs when freeing an allocated RDB object fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_DEFINE_VARIABLE (-1903)
Description This error occurs when defining an RDB host variable fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_BIND_VARIABLE (-1904)
Description This error occurs when binding an RDB host variable fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_PREPARE_STATEMENT (-1905)
Description This error occurs when preparing to execute an SQL statement fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_EXECUTE_STATEMENT (-1906)
Description This error occurs when executing an SQL statement fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

Chapter 2. Discrete Modules 23

TSAM_ERR_FETCH_STATEMENT (-1907)
Description This error occurs when performing a RDB Row Fetch fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_RETRIEVE_ROWID (-1908)
Description This error occurs when retrieving an RDB ROWID fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_RETRIEVE_ROW_COUNT (-1909)
Description This error occurs when retrieving the row counts in an RDB table fails.
Action

Refer to the displayed Oracle error message.

Reference

Refer to "Oracle Database Error Messages."

TSAM_ERR_TABLE_NAME_LENGTH (-1910)
Description This error occurs if there is a table name that exceeds 32 bytes when a dataset
name is converted to a table name during dataset creation in TSAM server.
Action

When creating a TSAM dataset by calling the CREATE API, if a dataset name
exceeds 26 bytes, the name of the dataset should be changed into that of the
table using tsam_filename(). tsam_filename() is able to convert the dataset name
into a table name whose length is 32 bytes.
Note that when creating a table using SQL without using IDCAMS or JCL, the
table name should not exceed 32 bytes.

Reference

Refer to the "Tibero TSAM Guide."

2.3. DSIO (-2000)
DSIO is a module that provides a standardized interface for all datasets (non-VSAM, VSAM,
and SPOOL). This section lists the error codes that can occur in the DSIO module, descriptions
of each error, suggested corrective actions, and in some cases, references for more information.

24 OpenFrame Error Message Reference Guide

DSIO_ERR_DUPLICATE_RECORD (-2001)
Description This error occurs when trying to WRITE a VSAM KSDS or RRDS dataset and a
record already exists with an identical key value.
Action

Check whether there is a record which has the identical key value in the dataset.
This error occurs if the application logic is not correct, or the application
implements improper procedure.

Reference

Refer to the "Chapter 3 VSAM Dataset" in the "OpenFrame Dataset Guide".

DSIO_ERR_DUPLICATE_KEY (-2002)
Description This error occurs when a duplicated key is detected when performing the
commands READ or WRITE from a dataset (secondary index dataset) where
key duplication is allowed.
Action

The message of the duplicated key detection can be ignored. When a duplicate
key is detected, if special business logic has to be executed, fork the application
logic.

Reference

Refer to the "Chapter 3 VSAM Dataset" in the "OpenFrame Dataset Guide".

DSIO_ERR_NOT_FOUND (-2003)
Description This error occurs when the record given to perform a READ from VSAM KSDS
or RRDS datasets has not been found.
Action

This is a common error that can occur from general business applications. The
countermeasure to this case should be applied to the business logic.

Reference

Refer to the "Chapter 3 VSAM Dataset" in the "OpenFrame Dataset Guide".

DSIO_ERR_END_OF_FILE (-2004)
Description This error occurs when the end of a file (EOF) is reached while performing
sequential READ commands for a sequential or VSAM dataset.
Action

This is a common error that can occur in general business applications. The
countermeasure to this case should be applied to the business logic.

Reference

Refer to the "OpenFrame Dataset Guide".

Chapter 2. Discrete Modules 25

DSIO_ERR_RECORD_LOCKED (-2005)
Description This error occurs when trying to READ FOR UPDATE a VSAM dataset and
another application has already locked the record.
Action

Wait until the lock status is released to perform the READ FOR UPDATE again
or remove the NOSUSPEND option.

Reference

Refer to the "Tibero TSAM Guide".

DSIO_ERR_RECORD_BUSY (-2006)
Description This error occurs when trying to READ from VSAM datasets and another
application has already locked the record.
Action

Wait until the lock status is released to perform the READ again or remove the
NOSUSPEND option.

Reference

Refer to the "Tibero TSAM Guide".

DSIO_ERR_INVALID_REQUEST (-2008)
Description This error occurs when a mandatory parameter is not transmitted when using
the DSIO library API.
Action

Revise the source code to send the mandatory parameter when calling the DSIO
library API.

DSIO_ERR_NOT_ALLOWED (-2009)
Description This error occurs when using actions not approved by the open mode, a mode
for setting the dataset as OPEN.
Action

Check the dataset type and modify the application to only use the allowed
commands.
Alternative, open mode should be set correctly when using the OPEN API for a
dataset.

Reference

Refer to the "OpenFrame Dataset Guide".

26 OpenFrame Error Message Reference Guide

DSIO_ERR_NO_SPACE (-2010)
Description This error occurs when performing a WRITE on a dataset and the disk space for
the dataset is insufficient.
Action

Check the available table space for the VSAM dataset and the available disk
space for the non-VSAM dataset.

DSIO_ERR_MEMORY_ALLOC (-2011)
Description This error occurs when system memory allocation fails.
Action

Contact the system administrator.

DSIO_ERR_INTERNAL (-2012)
Description This error occurs when there is a DSIO library internal error.
Action

Contact the TmaxSoft technical support team.

DSIO_ERR_NOT_IMPLEMENTED (-2013)
Description This error occurs when there is a DSIO library internal error. (Not Implemented)
Action

Contact the TmaxSoft technical support team.

DSIO_ERR_FILE_NOT_FOUND (-2014)
Description This error occurs when the dataset to be processed cannot be found. In many
cases, the dataset is cataloged but no physical storage is assigned.
Action

In the case of a non-VSAM dataset, check whether the file exists in the volume
directory. In the case of a VSAM dataset, check whether the table exists in the
volume table space.

DSIO_ERR_SHOULD_NOT_OCCUR (-2015)
Description This error occurs when there is a DSIO internal library error. (Unrealistic condition)
Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 27

DSIO_ERR_REWRITE_SIZE (-2016)
Description This error occurs when rewriting a new record to a dataset, if the record length
of the new record and the existing record do not match.
Action

When rewriting, the length of the new record and the existing one must match.

Reference

Refer to the "OpenFrame Dataset Guide".

DSIO_ERR_BUFFER_OVERFLOW (-2017)
Description This error occurs when the length of the dataset record to be read is bigger than
the buffer size.
Action

Provide a record buffer that is larger than the dataset record.

DSIO_ERR_INVALID_CONN_ID (-2101)
Description This error occurs when an incorrect connection ID is specified while using the
DSIO library directly.
Action

Revise the source code to send appropriate connection ID when calling the DSIO
library API.

DSIO_ERR_MAX_CONNECTIONS (-2102)
Description This error occurs when the number of connection requests exceed the maximum
number of simultaneous connections to use a VSAM or non-VSAM dataset when
using the DSIO library API directly.
Action

Revise the source code to share connections when using a VSAM or non-VSAM
dataset.

DSIO_ERR_DISCONNECTED (-2103)
Description This error occurs when the connection to the VSAM server has been lost while
performing I/O functions such as READ or WRITE on the dataset.
Action

Check the status of the VSAM dataset server and analyze the log to determine
the reason for the disconnection.

28 OpenFrame Error Message Reference Guide

DSIO_ERR_INVALID_TX_ID (-2201)
Description This error occurs when specifying an invalid transaction ID while using the DSIO
library API directly.
Action

Revise the source code to send an appropriate transaction ID when calling the
DSIO library API.

DSIO_ERR_MAX_TRANSACTIONS (-2202)
Description This error occurs when the number of transactions exceeds the maximum allowed
for dataset I/O, when using the DSIO library API.
Action

Revise the source code to close an existing transaction before starting a new
transaction.

DSIO_ERR_INVALID_FD (-2301)
Description This error occurs when specifying an invalid file descriptor while using the DSIO
library API directly.
Action

Revise the source code to send an appropriate file descriptor to call the DSIO
library API.

DSIO_ERR_MAX_OPEN_FILES (-2302)
Description This error occurs when more datasets are opened than is allowed.
Action

Close any datasets that are no longer in use by applications before opening
another dataset.

Reference

Up to 1,024 datasets can be opened concurrently.

DSIO_ERR_TSAM_CONFIGURATION (-2401)
Description This Error occurs due to an incorrect con figuration to access the VSAM dataset
server.
Action

Check whether the required configuration is set in the [TSAM_CLIENT] section
of the ds.conf configuration file.

Reference

Refer to the "Appendix. A Configuration File" in the "OpenFrame Dataset Guide".

Chapter 2. Discrete Modules 29

DSIO_ERR_NOT_INITIALIZED (-2403)
Description This error occurs when the DSIO BATCH library API is used directly without
calling the initialization function.
Action

Modify the source code to call the initialization function first before calling the
DSIO library API.

DSIO_ERR_CLOSED_WITH_LOCK (-2404)
Description This error occurs when a dataset to OPEN is already locked.
Action

Revise the application program.

DSIO_ERR_LOAD_FILE_OPEN (-2405)
Description This error occurs when creating a copy file to edit a dataset.
Action

Check whether file and directory access authority is granted.

DSIO_ERR_LOAD_FILE_WRITE (-2406)
Description This error occurs while creating a copy file to edit a dataset.
Action

Check whether there is enough space within the directory.

DSIO_ERR_SAVE_FILE_OPEN (-2407)
Description This error occurs when trying to OPEN the copy file for a modified dataset.
Action

Check whether directory and file access authority is granted.

DSIO_ERR_SAVE_FILE_READ (-2408)
Description This error occurs while trying to READ the copy file of a modified dataset.
Action

Check whether the record is saved in the file.

30 OpenFrame Error Message Reference Guide

DSIO_ERR_WRONG_INIT_FLAGS (-2410)
Description This error occurs when the flag setting to call the DSIO library initialization function
is incorrect.
Action

Check the input flag settings.

DSIO_ERR_WRONG_DCB_CONCATS (-2501)
Description This error occurs when there is a problem with the concatenated DCB provided
from allocator.
Action

Do not concatenate different types of datasets.

Reference

Refer to the "OpenFrame Dataset Guide".

DSIO_ERR_INVALID_DS_ACCESS (-2502)
Description This error occurs when executing a command that is not supported by a
non-VSAM dataset.
Action

Execute only the proper commands for the dataset type.

Reference

Refer to the "OpenFrame Dataset Guide".

DSIO_ERR_INVALID_OPERATION (-2503)
Description This error occurs when trying to call the DSIO API and it is not suited for the type
of the dataset.
Action

Use only the proper DSIO API according to the dataset type.

Reference

Refer to the "OpenFrame Dataset Guide".

DSIO_ERR_OPT_NOT_SUPPORTED(-2504)
Description This error occurs when an option is used that is not supported by dataset I/O.
Action

Check whether the option is supported.

Chapter 2. Discrete Modules 31

DSIO_ERR_TAPE_SIZE_CONFIG (-2505)
Description This error occurs when the calculation method for TAPE_SIZE is not specified
in the configuration file.
Action

Check the TAPE_SIZE setting in the ds.conf configuration file.

Reference

Refer to the "OpenFrame Dataset Guide".

DSIO_ERR_INVALID_DCB_TYPE(-2506)
Description This error occurs when an invalid DCB TYPE is configured.
Action

Contact the TmaxSoft technical support team.

DSIO_ERR_INVALID_CONN_TYPE(-2507)
Description This error occurs when an invalid CONNECTION TYPE is specified.
Action

Contact the TmaxSoft technical support team.

DSIO_ERR_INVALID_RID_TYPE(-2508)
Description This error occurs when an invalid RID TYPE is configured.
Action

Contact the TmaxSoft technical support team.

DSIO_ERR_SYSTEM_LSTAT(-2901)
Description This error occurs when the lstat() system function fails.
Action

Contact the system administrator.

Reference

Refer to the system error message when an error occurs.

DSIO_ERR_SYSTEM_POPEN(-2902)
Description This error occurs when the popen() system function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message when an error occurs.

32 OpenFrame Error Message Reference Guide

DSIO_ERR_SYSTEM_FREAD(-2903)
Description This error occurs when the fread() system function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message when an error occurs.

2.4. ICF (-3000)
The ICF module provides integrated catalog functions. This section lists the error codes for
errors that can occur in the ICF module, descriptions of each error, suggested corrective actions,
and in some cases, references to more information.

ICF_ERR_DUPLICATE_RECORD (-3001)
Description This error occurs when an identical catalog entry is already registered.
Action

Check whether the entry to be registered is already cataloged.

Reference

Refer to the "Chapter 4 Integrated Catalog" in the "OpenFrame Dataset Guide".

ICF_ERR_NOT_FOUND (-3002)
Description This error occurs when a catalog entry to be searched for is not registered.
Action

Check whether the entry to be searched is cataloged.

Reference

Refer to the "Chapter 4 Integrated Catalog" in the "OpenFrame Dataset Guide".

ICF_ERR_END_OF_FILE (-3003)
Description This error occurs when the end of a file is reached while BROWSING a catalog
using the ICF library API.
Action

Add logic to be used when the application using the ICF library API reaches the
end of the catalog.

ICF_ERR_MEMORY_ALLOC (-3004)
Description This error occurs when system memory allocation fails.

Chapter 2. Discrete Modules 33

Action

Contact the system administrator.

ICF_ERR_INTERNAL (-3005)
Description This error occurs when there is an ICF library internal error.
Action

Contact the TmaxSoft technical support team.

ICF_ERR_NOT_IMPLEMENTED (-3006)
Description This error occurs when there is an ICF library internal error. (Not Implemented)
Action

Contact the TmaxSoft technical support team.

ICF_ERR_INVALID_CATALOG_NAME (-3011)
Description This error occurs when a given catalog name is invalid when using the ICF library
API directly.
Action

When calling the ICF library API function, check whether the catalog name is
correct.

ICF_ERR_INALID_ENTRY_NAME (-3012)
Description This error occurs when a given entry name is invalid when using the ICF library
API directly.
Action

When calling the ICF library API function, check whether the entry name is
correct.

ICF_ERR_INVALID_ENTRY_TYPE (-3013)
Description This error occurs when a given entry type is invalid when using the ICF library
API directly.
Action

When calling the ICF library API function, check whether the entry type is correct.

34 OpenFrame Error Message Reference Guide

ICF_ERR_INVALID_ATTR_TYPE (-3014)
Description This error occurs when a given attribute type is invalid when using the ICF library
API directly.
Action

When calling the ICF library API function, check whether the given attribute type
is correct.

ICF_ERR_INVALID_HANDLE (-3015)
Description This error occurs when a given handle is invalid when using the ICF library API
directly.
Action

When calling the ICF library API function, check whether the given handle is
correct.

ICF_ERR_INVALID_FILTER_KEY (-3016)
Description This error occurs when a dataset filter key is incorrectly assigned during a catalog
search.
Action

Check whether the wild card provided for the catalog search is used correctly.

Reference

Refer to the "Chapter 4 Integrated Catalog" in the "OpenFrame Dataset Guide".

ICF_ERR_ICF_CONFIGURATION (-3021)
Description This error occurs when there is a problem in the default configuration file for
integrated catalog.
Action

Check the configurations for the [ICF_CATALOG] section in the ds.conf
configuration file and then correct any errors.

Reference

Refer to the "Appendix A. Configuration File" in the "OpenFrame Dataset Guide".

ICF_ERR_TSAM_CONFIGURATION (-3022)
Description This error occurs due to an incorrect configuration for the VSAM dataset access
used as integrated catalog storage.
Action

Check the configurations for the [ICF_STORAGE] section in the ds.conf
configuration file and then correct any errors.

Chapter 2. Discrete Modules 35

Reference

Refer to the "Appendix A. Configuration File" in the "OpenFrame Dataset Guide".

ICF_ERR_NOT_INITIALIZED (-3024)
Description This error occurs when the ICF library API is used directly without calling
initialization functions.
Action

The initialization function should be called before using the ICF library API.

ICF_ERR_BCS_NOT_OPENED (-3025)
Description This ICF library internal system error occurs when BCS is not open.
Action

Contact the TmaxSoft technical support team.

ICF_ERR_VVDS_NOT_OPENED (-3026)
Description This ICF library internal system error occurs when VVDS is not open.
Action

Contact the TmaxSoft technical support team.

ICF_ERR_SCAN_NOT_STARTED (-3027)
Description This ICF library internal system error occurs when SCAN does not start.
Action

Contact the TmaxSoft technical support team.

ICF_ERR_MAX_ASSOCIATONS (-3028)
Description This error occurs when using the ICF library API directly and when the number
of entries for a catalog exceeds the maximum number of entries.
Action

Modify the application to not exceed the number of entries for a single catalog.

Reference

The maximum number of entries for a single catalog is 477.

36 OpenFrame Error Message Reference Guide

ICF_ERR_BUFFER_OVERFLOW (-3029)
Description This error occurs when the number of buffers given to a search catalog is smaller
than the number of entries that have actually been searched.
Action

When searching a catalog, the buffer size for the result should be calculated
correctly.

ICF_ERR_CATALOG_NOT_DEFINED (-3031)
Description This error occurs when a BCS dataset with the given catalog name is not found.
Action

Check whether the specified user catalog is defined in the master catalog.

ICF_ERR_VOLUME_NOT_DEFINED (-3032)
Description This error occurs when a VVDS dataset corresponding to the volume specified
is not found.
Action

Check whether the specified volume of WDS dataset is defined in the master
catalog.

ICF_ERR_BCS_OPEN_ALREADY (-3033)
Description An ICF library internal system error which occurs when BCS is already open.
Action

Contact the TmaxSoft technical support team.

ICF_ERR_VVDS_OPEN_ALREADY (-3034)
Description An ICF library internal system error which occurs when VVDS is already open.
Action

Contact the TmaxSoft technical support team.

ICF_ERR_SCAN_STARTED_ALREADY (-3035)
Description An ICF library internal system error which occurs when SCAN is already started.
Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 37

ICF_ERR_NO_ALIAS_CATALOG (-3036)
Description This error occurs when the Alias Catalog corresponding to the dataset is not
found.
Action

Contact the TmaxSoft technical support team.

2.5. AMS (-4000)
The AMS module is responsible for creating, deleting, and cataloging a dataset. This section
lists the error codes that can occur in the AMS module, descriptions of each error code, suggested
corrective actions, and in some cases, references for more information.

AMS_ERR_DUPLICATE_RECORD (-4001)
Description

This error occurs when trying to add a record and a record already exists with
an identical key value.

Action

Check whether there is a record with an identical name and if so, change the
name of the record to be registered.

AMS_ERR_NOT_FOUND (-4002)
Description

This error occurs when the record to be searched is not found in the catalog.

Action

Check whether the item has been cataloged and then correct the name of the
record to be searched.

AMS_ERR_MEMORY_ALLOC (-4003)
Description

This error occurs when failing to allocate memory.

Action

Contact the system administrator.

AMS_ERR_INTERNAL (-4004)
Description

This error occurs when there is an internal AMS library error.

Action

Contact the TmaxSoft technical support team.

38 OpenFrame Error Message Reference Guide

AMS_ERR_NOT_IMPLEMENTED (-4005)
Description

This error occurs when there is an internal AMS library error. (Not implemented)

Action

Contact the TmaxSoft technical support team.

AMS_ERR_INVALID_CATALOG_NAME (-4011)
Description

This error occurs when a given catalog name is incorrect.

Action

When implementing the application, check whether the catalog name is correct.

AMS_ERR_INVALID_ENTRY_NAME (-4012)
Description

This error occurs when a given entry name is invalid.

Action

When implementing the application, check whether the entry name is correct.

AMS_ERR_INVALID_ENTRY_TYPE (-4013)
Description

This error occurs when a given entry type is invalid.

Action

When implementing the application, check whether the entry type is correct.

AMS_ERR_INVALID_DATASET_NAME (-4014)
Description

This error occurs when a given name of the dataset is invalid.

Action

When implementing the application, check whether the name of the dataset is
correct.

AMS_ERR_INVALID_VOLUME_SERIAL (-4016)
Description

This error occurs when the specified volume serial number is invalid.

Action

When implementing the application, check whether the volume serial number
is correct.

Chapter 2. Discrete Modules 39

AMS_ERR_INVALID_MEMBER_NAME (-4017)
Description

This error occurs when a given member name is invalid.

Action

When implementing the application, check whether the member name is correct.

AMS_ERR_INVALID_BASE_CLUSTER (-4018)
Description

This error occurs when a given dataset type for a base cluster is invalid.

Action

Check whether the dataset can be specified as a base cluster.

AMS_ERR_INVALID_DCB_TYPE (-4019)
Description

This error occurs when a given dataset type is invalid.

Action

When implementing the application, check whether the dataset type is
appropriate for the job.

AMS_ERR_INVALID_REQUEST (-4020)
Description

This error occurs when an invalid parameter is specified.

Action

Check whether the parameter is appropriate for the job.

AMS_ERR_TSAM_CONFIGURATION (-4021)
Description

This error occurs due to incorrect configuration for VSAM dataset access used
in an ASM library.

Action

Check whether the required configuration is set in the [TSAM_CLIENT] or
[SYS1_CLIENT] section of the ds.conf configuration file.

Reference

Refer to "Appendix A. Configuration File" of “OpenFrame Dataset Guide”.

AMS_ERR_NOT_INITIALIZED (-4023)
Description

This error occurs when the AMS library API is used without being initialized.

Action

The initialize function should be called before using the AMS library API.

40 OpenFrame Error Message Reference Guide

AMS_ERR_TOO_MANY_ENTRIES (-4024)
Description

This error occurs when multiple entries with the same name are found in the
catalog while searching for information about a specific catalog entry.

Action

When implementing the application, correctly specify the name of the entry to
be searched.

AMS_ERR_GDG_NOT_REGSTERED (-4025)
Description

This error occurs when the GDG entry cannot be found when registering or
searching in the GDS dataset.

Action

AMS_ERR_NO_PREVIOUS_GDS (-4026)
Description

This error occurs when the previous generation of the GDS dataset cannot be
found when registering or searching in the GDS dataset.

Action

Specify a generation number of the GDS dataset to be searched for, or register
the previous generation of GDS dataset.

AMS_ERR_BASE_ENTRY_NOT_FOUND (-4027)
Description

This error occurs when the base catalog entry needed to register the AIX,
PATH, or ALIAS catalog entry cannot be found.

Action

Check whether the name of the base entry is correctly specified or define the
base catalog entry first.

AMS_ERR_PDS_NOT_REGISTERED (-4028)
Description

This error occurs when the PDS cannot be found when adding or deleting a
PDS member.

Action

Check whether the name of the PDS dataset is well-defined.

Chapter 2. Discrete Modules 41

AMS_ERR_PDS_MEMBER_LIST (-4029)
Description

This error occurs while searching the PDS member list.

Action

Contact the TmaxSoft technical support team. (Refer to the displayed error
messages.)

AMS_ERR_ENTRY_NOT_RENAMED (-4030)
Description

This error occurs when failing to rename a catalog entry.

Action

If a non-VSAM dataset has a catalog entry related to the entry to be renamed
and its name cannot be changed.

AMS_ERR_GDS_ASSOC_FOUND (-4031)
Description

This error occurs when trying to delete a GDG catalog entry which has a related
GDS dataset.

Action

The GDG dataset should be deleted before the GDG entry, or the FORCE
option should be used to delete the GDG entry.

AMS_ERR_ENTRY_NOT_SUPPORTED (-4032)
Description

This error occurs when an invalid entry type is specified for a job to be
performed.

Action

Specify a valid entry type for the job to perform.

AMS_ERR_LOG_FILE_OPEN (-4801)
Description

This error occurs while opening a log file for writing.

Action

Contact the TmaxSoft technical support team. (Refer to the displayed error
messages.)

AMS_ERR_LOG_FILE_CLOSE (-4802)
Description

This error occurs while closing a log file after writing.

42 OpenFrame Error Message Reference Guide

Action

Contact the TmaxSoft technical support team. (Refer to the displayed error
messages.)

AMS_ERR_LOG_FILE_WRLCK (-4803)
Description

This error occurs while locking a log file for writing.

Action

Contact the TmaxSoft technical support team. (Refer to the displayed error
messages.)

AMS_ERR_LOG_FILE_UNLCK (-4804)
Description

This error occurs while unlocking a log file after writing.

Action

Contact the TmaxSoft technical support team. (Refer to the displayed error
messages.)

AMS_ERR_LOG_FILE_LSEEK (-4805)
Description

This error occurs while searching for a location to write a record in a log file.

Action

Contact the TmaxSoft technical support team. (Refer to the displayed error
messages.)

AMS_ERR_LOG_FILE_WRITE (-4806)
Description

This error occurs while writing a record in a log file with the write() function.

Action

Contact the TmaxSoft technical support team. (Refer to the displayed error
messages.)

AMS_ERR_SYSTEM_CREAT (-4901)
Description

This error occurs when the create() system function call fails.

Action

Contact the system administrator.

Reference

Refer to the displayed error messages.

Chapter 2. Discrete Modules 43

AMS_ERR_SYSTEM_UNLINK (-4902)
Description

This error occurs when the unlink() system function call fails.

Action

Contact the system administrator.

Reference

Refer to the displayed error messages.

AMS_ERR_SYSTEM_OPEN (-4903)
Description

This error occurs when the open() system function call fails.

Action

Contact the system administrator.

Reference

Refer to the displayed error messages.

AMS_ERR_SYSTEM_UTIME (-4904)
Description

This error occurs when the utime() system function call fails.

Action

Contact the system administrator.

Reference

Refer to the displayed error messages.

2.6. DSALC (-5000)
The DSALC module is responsible for allocation within datasets. This section lists the error
codes that can occur in the DSALC module, descriptions of each error code, suggested corrective
actions, and in some cases, references for more information.

DSALC_ERR_INVALID_REQUEST (-5001)
Description

This error occurs when an invalid parameter has been transmitted.

Action

Check whether the parameter is suited for the job.

DSALC_ERR_MEMORY_ALLOC (-5002)
Description

This error occurs when system memory allocation fails.

Action

Contact the system administrator.

44 OpenFrame Error Message Reference Guide

DSALC_ERR_NOT_INITIALIZED (-5003)
Description

This error occurs when the allocator library function is used without calling the
initialization function.

Action

Call the initialization function before using the allocator library function.

DSALC_ERR_INTERNAL (-5004)
Description

This error occurs when there is an allocator library internal system error.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_BUFFER_OVERFLOW (-5005)
Description

This error occurs when the buffer size provided for the allocator report function
is insufficient.

Action

Modify the application to call the report function after calculating the buffer size.

DSALC_ERR_NOT_IMPLEMENTED (-5009)
Description

This allocator library internal system error occurs when a function is not
implemented.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_SHMKEY (-5102)
Description

This error occurs when the key value for shared memory is invalid.

Action

Check the [DATASET_SHMKEY] section in the ds.conf configuration file.

Reference

Refer to the "Appendix A. Configuration File" in the "OpenFrame Dataset
Guide".

DSALC_ERR_SHMGET_FAILURE (-5105)
Description

This error occurs when the shared memory corresponding to a specified key
value is not accessible.

Chapter 2. Discrete Modules 45

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SHMAT_FAILURE (-5106)
Description

This error occurs when a process cannot be attached to the shared memory
corresponding to a specified key.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SHMDT_FAILURE (-5107)
Description

This error occurs when a process cannot be detached from the shared memory
corresponding to a specified key.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SHMCTL_STAT (-5108)
Description

This error occurs when an inquiry for the status information of shared memory
corresponding to a specified key fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SHMCTL_RMID (-5109)
Description

This error occurs when there is a failure to delete the shared memory
corresponding to a specified key.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

46 OpenFrame Error Message Reference Guide

DSALC_ERR_SHMDS_SEGSZ (-5110)
Description

This error occurs when the shared memory corresponding to the specified key
has an unexpected size.

Action

If the allocator library is patched, remove the existing shared memory and
restart.

Reference

Refer to ipcs and ipcrm in the UNIX Manual.

DSALC_ERR_DD_UNALLOCATE (-5111)
Description

This error occurs when there is an allocator library internal system error. (DD
Unallocate error)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_DDNAME (-5201)
Description

This error occurs when the specified DD name is invalid.

Action

Check whether the DD name is correct and try again.

DSALC_ERR_INVALID_DSNAME (-5202)
Description

This error occurs when the specified name for a dataset is invalid.

Action

Check whether the dataset name is correct and execute again.

DSALC_ERR_INVALID_HANDLE (-5203)
Description

This error occurs when there is an allocator library usage error. (Invalid Handle)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_HEADER (-5204)
Description

This error occurs when there is an allocator library usage error. (Invalid Header)

Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 47

DSALC_ERR_DUPLICATE_HEADER (-5205)
Description

This error occurs when there is an allocator library usage error. (Duplicate
Header)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_CONCAT (-5206)
Description

This error occurs when there is an Allocator library usage error. (Invalid Contact)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_COUNT (-5207)
Description

This error occurs when there is an Allocator library usage error. (Invalid Count)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_REPORT (-5208)
Description

This error occurs when there is an Allocator library usage error. (Invalid Report)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_ALREADY_CATALOGED (-5211)
Description

This error occurs when the new dataset is already cataloged.

Action

Delete the dataset and execute again.

DSALC_ERR_DATASET_NOT_FOUND (-5212)
Description

This error occurs when an existing dataset is not found.

Action

Delete the dataset and execute again.

48 OpenFrame Error Message Reference Guide

DSALC_ERR_DATASET_DUPLICATE (-5213)
Description

This error occurs when a new dataset already exists.

Action

Delete the dataset and execute again.

DSALC_ERR_UNSUPPORTED_ENTRY (-5221)
Description

This error occurs when an entry registered in the catalog is not a supported
type.

Action

Check whether another entry is registered with the same name using a catalog
search.

DSALC_ERR_CONCATENATE_ENTRY (-5222)
Description

This error occurs when an entry registered in the catalog cannot be
concatenated.

Action

Try to concatenate only those entries which can be concatenated.

Reference

VSAM datasets cannot be concatenated.

DSALC_ERR_INVALID_SLOT_INFO (-5231)
Description

This error occurs when there is an Allocator library internal system error. (Invalid
Slot Info)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_NO_AVAILABLE_SLOT (-5232)
Description

This error occurs when there are no more available memory slots for an
allocator.

Action

Use the allocator slot dump tool to check the status of the memory slot that is
currently in use.

Reference

The maximum number of available memory slots for the allocator is 65535.
(check the ds.conf configuration file)

Chapter 2. Discrete Modules 49

DSALC_ERR_OUTPUT_CONCATENATE (-5241)
Description

This error occurs when trying to concatenate an output dataset.

Action

Concatenate does not work for output datasets.

Reference

Refer to "Chapter 2. Non-VSAM Dataset" in the "OpenFrame Dataset Guide".

DSALC_ERR_VOLUME_ALLOC_DISP (-5242)
Description

This error occurs when an abnormal DISP parameter has been passed.

Action

Revise the incorrect DISP parameter.

Reference

In order to allocate the volume use DISP=(SHR,KEEP,KEEP) or
DISP=(OLD,KEEP,KEEP).

DSALC_ERR_ABNORMAL_DISP_PASS (-5243)
Description

This error occurs when an abnormal DISP parameter has been passed.

Action

Revise the incorrect DISP parameter.

Reference

"PASS" cannot be used as an Abnormal Termination DISP parameter.

DSALC_ERR_CONCAT_DISP_PASS (-5244)
Description

This error occurs when an abnormal DISP parameter has been passed.

Action

Revise the incorrect DISP parameter.

Reference

A concatenated dataset cannot use 'PASS' as a DISP parameter. (allowed as
of Base V5.1)

DSALC_ERR_PATH_ALLOC_INFO (-5245)
Description

This error occurs when trying to allocate VSAM PATH and the information
related to the PATH item in the catalog is invalid.

Action

Check the catalog to determine whether the information related to the PATH
item is correctly specified and then correct the catalog.

Reference

Refer to "Chapter 3. VSAM Dataset" in the "OpenFrame Dataset Guide."

50 OpenFrame Error Message Reference Guide

DSALC_ERR_AIX_ASSOC_INFO (-5246)
Description

This error occurs when trying to allocate VSAM PATH and the information
related to the AIX item in catalog is invalid.

Action

Check the catalog to determine whether the information related to the AIX item
is correctly specified and then correct the catalog.

Reference

Refer to "Chapter 3. VSAM dataset" in the "OpenFrame Dataset Guide".

DSALC_ERR_UNIT_VOLUME_MISMATCH (-5247)
Description

This error occurs when allocating a dataset and a given UNIT parameter does
not match the VOLUME parameter.

Action

Check the UNIT and VOLUME information registered in the system then send
the parameter again.

Reference

Refer to "Appendix A. Configuration File" in "OpenFrame Dataset Guide".

DSALC_ERR_UNIT_NOT_GIVEN (-5248)
Description

This error occurs when the UNIT parameter has not been specified even though
it is needed to allocate a dataset.

Action

If DS_OLDSHR_UNIT_METHOD=NEW is set in ds.conf, and DISP is set to
OLD or SHR, check whether or not UNIT information has been specified the
VOLUME information.

Reference

Refer to "Appendix A. Configuration File" in "OpenFrame Dataset Guide".

DSALC_ERR_MODEL_NOT_FOUND (-5251)
Description

This error occurs when the model dataset specified to define the attribute of
the dataset cannot be found.

Action

Check whether the module dataset specified in JCL exists.

DSALC_ERR_VSAM_TERM_DISP (-5252)
Description

This error occurs when the DISP parameter for a VSAM dataset is not
supported.

Chapter 2. Discrete Modules 51

Action

Specify a DISP parameter supported by the VSAM dataset in the JCL.

Reference

Refer to "Chapter 3. VSAM Dataset" in the "OpenFrame Dataset Guide".

DSALC_ERR_UNKNOWN_DCB_TYPE (-5253)
Description

This error occurs when there is an allocator library internal system error.
(Unknown DCB Type)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_DCB_NAME (-5254)
Description

This error occurs when there is an allocator library internal system error. (Invalid
DCB Name)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_CATNAME_DIFFERENT (-5255)
Description

This error occurs when there is an allocator library internal system error.
(Catname Different)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_ENTYPE_DIFFERENT (-5256)
Description

This error occurs when there is an allocator library internal system error. (Entype
Different)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_RECAT_NOT_ALLOWED (-5257)
Description

This error occurs when the dataset is closed and recataloging is not supported.

Action

Check the type of the dataset and then specify a DISP parameter corresponding
to the JCL.

Reference

Recataloging is not supported for a GDS dataset or a PDS member.

52 OpenFrame Error Message Reference Guide

DSALC_ERR_REMOVE_DATASET (-5258)
Description

This error occurs when trying to use an allocator library. (Remove Dataset)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_UPDATE_VTOC_ELEMENT (-5260)
Description

This error occurs when trying to use an allocator library. (Update VTOC
Element)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_LOCK_INITIALIZE (-5261)
Description

This error occurs when trying to use an allocator library. (Lock Initialize)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_ALLOC_TYPE (-5262)
Description

This error occurs when trying to use an allocator library. (Invalid Alloc Type)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_REFDD_FORMAT (-5271)
Description

This error occurs due to an invalid format of the JCL Reference DD.

Action

Check the format of the REFDD parameter.

DSALC_ERR_STEPPATH_REQUIRED (-5272)
Description

This error occurs when trying to use an allocator library. (Steppath Required)

Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 53

DSALC_ERR_REFDD_NOT_FOUND (-5273)
Description

This error occurs when the Reference DD is not found in the JCL.

Action

Check whether the REFDD parameter is correctly specified.

DSALC_ERR_RENEW_GDS_DATASET (-5295)
Description

The RENEW DISP parameter is not allowed for GDS datasets.

Action

Check whether the DISP parameter is correctly specified.

DSALC_ERR_RENEW_WITH_MEMBER (-5296)
Description

The RENEW DISP parameter is not allowed for a member of a PDS dataset.

Action

Check whether the DISP parameter is correctly specified.

DSALC_ERR_CONCAT_LEADER_PASS (-5401)
Description

This error occurs because a dataset that is allocated with a disposition of PASS
cannot be a concatenation leader.

Action

Check the DD statement of JCL. (allowed as of Base V5.1)

DSALC_ERR_SWITCH_CONCAT_SLOT (-5402)
Description

This error occurs when trying to switch an attribute of the concatenated dataset
which is not allowed to be switched in the next JCL step.

Action

Check the DD statement of the JCL.

DSALC_ERR_SWITCH_NODISP_SLOT (-5403)
Description

This error occurs when trying to switch an attribute of the spool dataset which
is not allowed to be switched in the next JCL step.

Action

Contact the TmaxSoft technical support team.

54 OpenFrame Error Message Reference Guide

DSALC_ERR_DUMMY_SWITCH_DSNAME (-5411)
Description

This error occurs when trying to switch a DSNAME attribute of the dummy
dataset which is not allowed to be switched in the next JCL step.

Action

Check the DD statement of JCL.

DSALC_ERR_DUMMY_SWITCH_VOLSER (-5412)
Description

This error occurs when trying to switch a VOLSER attribute of the dummy
dataset which is not allowed to be switched in the next JCL step.

Action

Check the DD statement of the JCL.

DSALC_ERR_VOLUME_SWITCH_DSNAME (-5421)
Description

This error occurs when trying to switch a DSNAME attribute of the volume
dataset which is not allowed to be switched in the next JCL step.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_VOLUME_SWITCH_VOLSER (-5422)
Description

This error occurs when trying to switch a VOLSER attribute of the volume
dataset which is not allowed to be switched in the next JCL step.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_VOLUME_SWITCH_DISP (-5431)
Description

This error occurs when an invalid disposition is specified when switching an
attribute in the next JCL step of the volume dataset.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_NOTAPE_SWITCH_DSNAME (-5441)
Description

This error occurs when trying to switch a DSNAME attribute in the next JCL
step of a dataset which is not a tape dataset.

Chapter 2. Discrete Modules 55

Action

Check the DD statement of the JCL.

DSALC_ERR_NOTAPE_SWITCH_VOLSER (-5442)
Description

This error occurs when trying to switch a VOLSER attribute in the next JCL
step of a dataset which is not a tape dataset.

Action

Check the DD statement of the JCL.

DSALC_ERR_NONPDS_SWITCH_MEMBER (-5443)
Description

This error occurs when trying to switch a MEMBER attribute in the next JCL
step of a dataset which is not a PDS dataset.

Action

Check the DD statement of JCL.

DSALC_ERR_CATLDS_SWITCH_DSNAME (-5444)
Description

This error occurs when trying to switch a DSNAME attribute in the next JCL
step of a cataloged dataset.

Action

Check the DD statement of JCL.

DSALC_ERR_CATLDS_SWITCH_VOLSER (-5445)
Description

This error occurs when trying to switch a VOLSER attribute in the next JCL
step of a cataloged dataset.

Action

Check the DD statement of JCL.

DSALC_ERR_SPOOL_ALLOC_DISP (-5501)
Description

This error occurs when a SPOOL dataset has not been assigned a valid DISP
parameter.

Action

Contact the TmaxSoft technical support team.

56 OpenFrame Error Message Reference Guide

DSALC_ERR_DBIO_ALLOC_DISP (-5511)
Description

This error occurs when a DBIO dataset has not been assigned a valid DISP
parameter.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_NEED_VOLSER_LIST (-5512)
Description

In order to allocate a DBIO dataset, a volume serial list must be assigned.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_TERM_ID (-5521)
Description

This error occurs when a TERMINAL dataset has not been assigned a valid
Terminal ID.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_TERM_ALLOC_DISP (-5522)
Description

This error occurs when a terminal dataset has not been assigned a valid DISP
parameter.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_STRNAME (-5531)
Description

This error occurs when an STDIO dataset has not been assigned a valid stream
name.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_STDIO_ALLOC_DISP (-5532)
Description

This error occurs when an STDIO dataset has not been assigned a valid DISP
parameter.

Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 57

DSALC_ERR_INVALID_MQNNAME (-5541)
Description

This error occurs when an MQNIO dataset has not been assigned a valid MQN
node name.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_MQNIO_ALLOC_DISP (-5542)
Description

This error occurs when an MQNIO dataset has not been assigned a valid DISP
parameter.

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_ALREADY_IN_CRITICAL (-5901)
Description

This error occurs when there is an allocator library internal system error.
(Already In Critical)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_NOT_IN_CRITICAL (-5902)
Description

This error occurs when there is an allocator library internal system error. (Not
In Critical)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_LOG_FILE_OPEN (-5903)
Description

This error occurs when a dataset allocator log file cannot be opened.

Action

Check whether access rights for the dataset allocator log file or directory are
granted.

DSALC_ERR_LOG_FILE_WRITE (-5904)
Description

This error occurs when writing to a dataset allocator log file has failed.

58 OpenFrame Error Message Reference Guide

Action

Check whether access rights for the dataset allocator log file or directory are
granted.

DSALC_ERR_LOG_OPEN_ALREADY (-5905)
Description

This error occurs when trying to use the allocator library. (Log Open Already)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_LOG_NOT_OPEN_YET (-5906)
Description

This error occurs when trying to use an allocator library. (Log Not Open Yet)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_LOG_FILE_WRLCK (-5907)
Description

This error occurs when trying to use an allocator library. (Log File Wrlck)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_LOG_FILE_UNLCK (-5908)
Description

This error occurs when trying to use an allocator library. (Log File Unlck)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_INVALID_LOG_FD (-5909)
Description

This error occurs when trying to use an allocator library. (Invalid Log FD)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_LOG_FILE_CLOSE (-5910)
Description

This error occurs when trying to use an allocator library. (Log File Close)

Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 59

DSALC_ERR_LOG_FILE_LSEEK (-5911)
Description

This error occurs when trying to use an allocator library. (Log File LSEEK)

Action

Contact the TmaxSoft technical support team.

DSALC_ERR_SYSTEM_LSTAT (-5991)
Description

This error occurs when the system call lstat() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_OPENDIR (-5992)
Description

This error occurs when the system call opendir() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_MKDIR (-5993)
Description

This error occurs when the system call mkdir() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_RMDIR (-5994)
Description

This error occurs when the system call rmdir() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_FOPEN (-5995)
Description

This error occurs when the system call fopen() fails.

Action

Contact the system administrator.

60 OpenFrame Error Message Reference Guide

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_OPEN (-5996)
Description

This error occurs when the system call open() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_UNLINK (-5997)
Description

This error occurs when the system call unlink() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_SIGNAL(-5998)
Description

This error occurs when the system call signal() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

DSALC_ERR_SYSTEM_POPEN (-5999)
Description

This error occurs when the system call popen() fails.

Action

Contact the system administrator.

Reference

Refer to the system error message that is displayed when an error occurs.

2.7. VOLM (-6000)
The VOLM module is responsible for volume information inquiries and VTOC management.
This section lists the error codes that can occur in the VOLM module, descriptions of each error
code, suggested corrective actions, and in some cases, references for more information.

Chapter 2. Discrete Modules 61

VOLM_ERR_INVALD_REQUEST (-6001)
Description This error occurs when using the VOLM library API directly and an abnormal
parameter was passed.
Action

If using the API directly, send a parameter that is valid for the job to be performed.
Otherwise, contact the TmaxSoft technical support team.

VOLM_ERR_MEMORY_ALLOC (-6002)
Description This error occurs when memory allocation fails.
Action

Contact the system administrator.

VOLM_ERR_BUFFER_OVERFLOW (-6003)
Description This error occurs when insufficient buffer space is allocated for calling a data
inquiry function.
Action

Allocate sufficient buffer space.

VOLM_ERR_ELEMENT_NOT_FOUND (-6004)
Description This error occurs when the VTOC information of a dataset cannot be found.
Action

Check whether the dataset exists on the volume.

VOLM_ERR_HEADER_CONFIGURATION (-6005)
Description This error occurs when a value in the [HEADER] section in unit.conf or
volume.conf is invalid.
Action

Check if the value is between 1 and 4096.

VOLM_ERR_NOT_IMPLEMENTED (-6009)
Description This error occurs when there is a VOLM library internal system error. (Not
Implemented)
Action

Contact the TmaxSoft technical support team.

62 OpenFrame Error Message Reference Guide

VOLM_ERR_GROUP_NOT_DEFINED (-6101)
Description This error occurs when a specified esoteric unit name is not registered in the
system.
Action

Check whether the specified esoteric name is registered in the unit.conf file. If
not, register it or revise the UNIT parameter of the JCL.

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_GROUP_CONFIGURATION (-6102)
Description This error occurs when the configuration of the [ESOTERIC] section in the
unit.conf file is incorrect.
Action

Revise the [ESOTERIC] section of the unit.conf file.

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_DEVICE_CONFIGURATION (-6103)
Description This error occurs when the configuration of the [DEVICE] section in the unit.conf
file is incorrect.
Action

Revise the [DEVICE] section of the unit.conf file.

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_UNKNOWN_DEVICE_TYPE (-6104)
Description This error occurs when an unknown device type was passed.
Action

Check whether the device type is incorrectly specified. If the specified device
type is correct, contact the TmaxSoft technical support team.

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_DEVICE_NOT_DEFINED (-6105)
Description This error occurs when an unknown device number has been passed.
Action

Check whether the device number is incorrectly specified. If necessary, register
the device number in the unit.conf file.

Chapter 2. Discrete Modules 63

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_NO_DEFAULT_VOLSER (-6201)
Description This error occurs when the default volume serial number is not defined in a
system.
Action

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_DEF_VOLSER_CONFIG (-6202)
Description This error occurs when the default value serial number configuration is incorrect.
Action

Revise incorrect configuration in the ds.conf file.

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_VOLUME_CONFIGURATION (-6203)
Description This error occurs when the volume.conf file is incorrect.
Action

Revise incorrect configuration in the volume.conf file.

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_VOLUME_NOT_DEFINED (-6204)
Description This error occurs when an unknown volume serial number has been passed.
Action

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

VOLM_ERR_NO_PRIMARY_VOLUME (-6301)
Description This error occurs when there is no primary volume serial number corresponding
to a specified device name.
Action

Reference

Refer to "Appendix A. Configuration File" in the “OpenFrame Dataset Guide.”

64 OpenFrame Error Message Reference Guide

VOLM_ERR_NO_AMPLE_VOLUME (-6302)
Description This error occurs when the volume serial number is linked to a volume with
insufficient disk space.
Action

Enlarge the disk space linked to a volume serial number or register a new volume
serial number.

VOLM_ERR_VOLUME_NOT_FOUND (-6303)
Description This error occurs when the described volume information cannot be found.
Action

Check whether the described volume exists in the system.

VOLM_ERR_MAX_DEVICE_NUMBER (-6304)
Description This error occurs when the number of defined devices exceeds the maximum
allowed in OpenFrame.
Action

Only define necessary devices in the unit.conf configuration file.

Reference

The maximum number of devices that can currently be defined in OpenFrame
is 1024.

VOLM_ERR_INVALID_FILTER_KEY (-6401)
Description This error occurs when using an invalid FILTER KEY.
Action

Check whether the FILTER KEY is valid.

VOLM_ERR_VTOC_OPEN_ALREADY (-6501)
Description This error occurs when there is a VOLM library internal system error. (VTOC
Open Already)
Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 65

VOLM_ERR_VTOC_NOT_OPEN_YET (-6502)
Description This error occurs when there is a VOLM library internal system error. (VTOC Not
Open Yet)
Action

Contact the TmaxSoft technical support team.

VOLM_ERR_VTOC_OPEN_MODE (-6503)
Description This error occurs when there is a VOLM library internal system error. (VTOC
Open Mode)
Action

Contact the TmaxSoft technical support team.

VOLM_ERR_INVALID_VTOC_FD (-6504)
Description This error occurs when there is a VOLM library internal system error. (Invalid
VTOC FD)
Action

Contact the TmaxSoft technical support team.

VOLM_ERR_VTOC_CORRUPTED (-6505)
Description This error occurs when the VTOC table is corrupt.
Action

Contact the TmaxSoft technical support team.

VOLM_ERR_VTOC_IO_FAILURE (-6506)
Description This error occurs in I/O of the VTOC information.
Action

Contact the TmaxSoft technical support team.

VOLM_ERR_SYSTEM_LSTAT (-6901)
Description This error occurs when the lstat() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

66 OpenFrame Error Message Reference Guide

VOLM_ERR_SYSTEM_CREAT (-6902)
Description This error occurs when the creat() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_UNLINK (-6903)
Description This error occurs when the unlink() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_OPEN (-6904)
Description This error occurs when the open() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_FCNTL (-6905)
Description This error occurs when the fcntl() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_CLOSE (-6906)
Description This error occurs when the close() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_READ (-6907)
Description This error occurs when the read() function call fails.

Chapter 2. Discrete Modules 67

Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_WRITE (-6908)
Description This error occurs when the write() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_LSEEK (-6909)
Description This error occurs when the lseek() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

VOLM_ERR_SYSTEM_OPENDIR (-6910)
Description This error occurs when the opendir() function call fails.
Action

Contact the system administrator.

Reference

Refer to the system error message displayed when this error occurs.

2.8. LOCKM (-7000)
The LOCKM module is a Lock server client module. This section lists the error codes that can
occur in the LOCKM module, descriptions of each error code, suggested corrective actions,
and in some cases, references for more information.

LOCKM_ERR_INTERRUPTED (-7007)
Description This error occurs when disabling a job waiting for a response to a lock request
with the STOP command.
Action

Check the status of the job waiting for a response to the lock request.

68 OpenFrame Error Message Reference Guide

LOCKM_ERR_INVALID_REQUEST (-7011)
Description This error occurs when an invalid parameter is used to call a function or Tmax
service.
Action

Restart the ofrlmsvr and ofrlmwrk servers, or check whether the node name is
correctly specified.

LOCKM_ERR_MAX_DATA_EXCEEDED (-7014)
Description This error occurs when the number of locks exceeds the maximum possible
number of locks on a dataset with the same JOBID or PID. (999,999)
Action

Release unnecessary locks.

LOCKM_ERR_CONFIG_ERROR (-7015)
Description This error occurs when LOCK_DATASET, LOG_DATASET, SEQNO_FILE,
RECOVERY_TIME or LOG_CLEANUP is not correctly specified in the
[LOCK_SERVER] section of the ds.conf configuration file.
Action

Check the specified value.

Reference

Refer to "[LOCK SERVER]" in section "A.5. ds.conf" of the "OpenFrame Dataset
Guide."

LOCKM_ERR_LOCK_NAME_IS_EMPTY (-7022)
Description This error occurs when a lock is requested on a dataset whose name has not
been defined.
Action

Contact the TmaxSoft technical support team.

LOCKM_ERR_NODENAME_LENGTH_FAILURE (-7024)
Description This error occurs when the length of a node name exceeds 64 bytes.
Action

Check the system node name and then limit the node name length to 64 bytes.

Chapter 2. Discrete Modules 69

LOCKM_ERR_ALREADY_LOCKED (-7032)
Description This error occurs when any lock is requested when another application holds an
exclusive lock.
Action

Check the application that has requested a lock on the dataset through tjesmgr
or OFAdmin and then release unnecessary locks.

LOCKM_REQUEST_CANCELLED (-7035)
Description This error occurs when an application that sent a lock request has been disabled
by another application.
Action

Check the status of the disabled application then try again.

LOCKM_ERR_DEADLOCK_DETECTED (-7036)
Description This error occurs when a deadlock is detected.
Action

Check the deadlock information through tjesmgr or OFAdmin and then disable
the locks.

LOCKM_ERR_MEMORY_ALLOC (-7041)
Description This error occurs when system memory allocation fails.
Action

Check if there is sufficient memory space in the system.

LOCKM_ERR_SEND_SUCCESS_IMMEDIATE (-7062)
Description This error occurs when immediately replying to the client that sent a lock request.
This error message is not delivered to the client.
Action

LOCKM_ERR_LMWRK_FAIL (-7063)
Description This error occurs when the ofrlmwrk server has not been started.
Action

Check whether the ofrlmwrk server has successfully started.

70 OpenFrame Error Message Reference Guide

LOCKM_ERR_LMSVR_TPACALL_FAIL (-7064)
Description This error occurs when the tpacall() function call fails.
Action

Check the Tmax error code in the ofrmwk server log.

LOCKM_ERR_TMPLOCK_FILE_OPEN (-7066)
Description This error occurs when an attempt to open a sequential file on the server fails.
Action

Check whether the read and write permissions specified in the SEQNO_FILE
item of the [LOCK_SERVER] section of the ds.conf file are granted to the
directory.

Reference

Refer to "[LOCK SERVER]" in section "A.5. ds.conf" of the "OpenFrame Dataset
Guide."

LOCKM_ERR_TMPLOCK_FILE_READ (-7072)
Description This error occurs when attempting to read a sequential file on the server fails.
Action

Check whether read permission to the file has been granted.

LOCKM_ERR_TMPLOCK_FILE_WRITE (-7073)
Description This error occurs when attempting to write to a sequential file on the server fails.
Action

Check whether write permission to the file has been granted.

LOCKM_ERR_ANOTHER_OBMLMSVR_ALIVE (-7076)
Description This error occurs when two or more Lock servers are started.
Action

Terminate the server that is currently running and then start the new server.

LOCKM_ERR_INVALID_TOKEN (-7102)
Description This error occurs when an invalid token has been passed from the client.
Action

Terminate the application and then try again.

Chapter 2. Discrete Modules 71

LOCKM_ERR_TSAM_CONNECT_FAIL (-7501)
Description This error occurs when the connection to TSAM has failed.
Action

Check whether the TSAM access information configured in the [TSAM_CLIENT]
section of the ds.conf file is correct.

LOCKM_ERR_TSAM_DISCONNECT_FAIL (-7502)
Description This error occurs when disabling the TSAM connection fails.
Action

Check the status of the TSAM server and then restart the ofrlmsvr and ofrlmwrk
servers.

LOCKM_ERR_TSAM_OPEN_FAIL (-7503)
Description This error occurs when there is a failure to call the tsam_open() function for a
LOCK dataset or a LOG dataset.
Action

Check whether LOCK dataset or LOG dataset exists in the LOCK_DATASET or
LOG_DATASET field of the [LOCK_SERVER] section of the ds.conf file.

LOCKM_ERR_TSAM_CLOSE_FAIL (-7504)
Description This error occurs when there is a failure to call the tsam_close() function for
LOCK dataset or LOG dataset.
Action

Check the status of the TSAM server and then restart the ofrlmsvr and ofrlmwrk
servers.

LOCKM_ERR_TSAM_TX_START (-7505)
Description This error occurs when the tsam_tx_start() function call fails.
Action

Check the status of the TSAM server and then restart the ofrlmsvr and ofrlmwrk
servers.

72 OpenFrame Error Message Reference Guide

LOCKM_ERR_TSAM_TX_END_FAIL (-7506)
Description This error occurs when the tsam_tx_end() function call fails.
Action

Check the status of the TSAM server and then restart the ofrlmsvr and ofrlmwrk
servers.

LOCKM_ERR_TSAM_FILENAME_FAIL (-7508)
Description This error occurs when the tsam_filename() function call fails.
Action

Check whether the LOCK dataset or LOG dataset exists in the LOCK_DATASET
or LOG_DATASET field of the [LOCK_SERVER] section of the ds.conf
configuration file.

LOCKM_ERR_TSAM_TX_COMMIT_FAIL (-7509)
Description This error occurs when the tsam_tx_commit() function call fails.
Action

Check the status of the TSAM server and then restart the ofrlmsvr and ofrlmwrk
servers.

LOCKM_ERR_TSAM_TX_ROLLBACK_FAIL (-7510)
Description This error occurs when the tsam_tx_rollback() function call fails.
Action

Check the status of the TSAM server and then restart the ofrlmsvr and ofrlmwrk
servers.

LOCKM_ERR_LOCK_DATASET_NOT_OPENED (-7511)
Description This error occurs when trying to read or write to an unopened LOCK dataset.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

LOCKM_ERR_LOG_DATASET_NOT_OPENED (-7512)
Description This error occurs when trying to read or write to an unopened LOG dataset.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

Chapter 2. Discrete Modules 73

LOCKM_ERR_RECORD_NOT_FOUND (-7513)
Description This error occurs when the lock to be released is not found in the lock dataset.
Action

Check whether the lock dataset is initialized. If this type of error occurs often,
contact the system administrator.

LOCKM_ERR_END_OF_FILE (-7514)
Description This error occurs when EOF is reached while reading a LOCK dataset or LOG
dataset.
Action

Contact the TmaxSoft technical support team.

LOCKM_ERR_TSAM_DUPLICATE_RECORD (-7515)
Description This error occurs when trying to add a record to a LOCK dataset and a record
already exists with an identical key value.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

LOCKM_ERR_TSAM_READ_FAIL (-7516)
Description This error occurs when the tsam_read() function call fails.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

LOCKM_ERR_TSAM_WRITE_FAIL (-7517)
Description This error occurs when the tsam_write() function call fails.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

LOCKM_ERR_TSAM_START_BR (-7518)
Description This error occurs when the tsam_start_br() function call fails.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

74 OpenFrame Error Message Reference Guide

LOCKM_ERR_TSAM_END_BR (-7519)
Description This error occurs when the tsam_end_br() function call fails.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

LOCKM_ERR_TSAM_READ_NEXT_FAIL (-7520)
Description This error occurs when the tsam_read_next() function call fails.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

LOCKM_ERR_TSAM_DELETE_FAIL (-7521)
Description This error occurs when the tsam_delete() function call fails.
Action

Restart the ofrlmsvr and ofrlmwrk servers.

2.9. PGMDD (-8000)
The PGMDD module is a module which queries the assigned dataset with the DD name. This
section lists the error codes that can occur in the PGMDD module, descriptions of each error
code, suggested corrective actions, and in some cases, references for more information.

PGMDD_ERR_INVALID_REQUEST (-8001)
Description This error occurs when an invalid parameter has been transmitted.
Action

Check whether the parameter is correct to the job and then correct it.

PGMDD_ERR_MEMORY_ALLOC (-8002)
Description This error occurs when memory allocation fails.
Action

Contact the system administrator.

Chapter 2. Discrete Modules 75

PGMDD_ERR_NOT_INITIALIZED (-8003)
Description This error occurs when the PGMDD library function is used without being
initialized.
Action

Call the initialize function before using the PGMDD library function.

PGMDD_ERR_BUFFER_OVERFLOW (-8004)
Description This error occurs when the buffer provided by the search function is too small.
Action

Calculate the buffer size accurately and then provide a larger buffer to store
information.

PGMDD_ERR_NOT_IMPLEMENTED (-8009)
Description This error occurs when there is a PGMDD library internal system error. (Not
Implemented)
Action

Contact the TmaxSoft technical support team.

PGMDD_ERR_INVALID_DDNAME (-8201)
Description This error occurs when a specified DD name is invalid.
Action

Check whether the DD name is correctly specified.

PGMDD_ERR_INVALID_HANDLE (-8202)
Description This error occurs when there is a PGMDD library usage error. (Invalid Handle)
Action

Contact the TmaxSoft technical support team.

PGMDD_ERR_DD_NOT_FOUND (-8203)
Description This error occurs when the user-defined DD is not found.
Action

Check whether the DD is defined in the JCL which executes the job.

76 OpenFrame Error Message Reference Guide

PGMDD_ERR_GETENV_FORMAT (-8204)
Description This error occurs when there is a PGMDD library internal system error. (Getenv
Format)
Action

Contact the TmaxSoft technical support team.

PGMDD_ERR_DUPLICATE_HEADER (-8205)
Description This error occurs when there is a PGMDD library usage error. (Duplicate Header)
Action

Contact the TmaxSoft technical support team.

PGMDD_ERR_GETENV_HANDLE (-8207)
Description This error occurs when there is a PGMDD library internal system error. (Getenv
Handle)
Action

Contact the TmaxSoft technical support team.

PGMDD_ERR_SYSTEM_PUTENV (-8901)
Description This error occurs when the putenv() function call fails.
Action

Contact the system administrator.

Reference

Refer to the displayed error messages.

2.10. TJES (-9000)
The TJES module is responsible for managing Batch JOBs. This section lists the error codes
that can occur in the TJES module, descriptions for each error code, suggested corrective action,
and in some cases, references for more information.

TJES_ERR_NOT_INITIALIZED (-9001)
Description This error occurs when the TJES library is used without being initialized.
Action

Contact the TmaxSoft technical support team.

Chapter 2. Discrete Modules 77

TJES_ERR_NOT_CONNECTED (-9002)
Description This error occurs when trying to use a TSAM dataset while not connected to
TSAM.
Action

Check if TSAM is available. Correct the problem, or if no problem is found, contact
the TmaxSoft technical support team.

Reference

Refer to the “OpenFrame Dataset Guide”.

TJES_ERR_TX_NOT_STARTED (-9003)
Description This error occurs when using the TSAM record I/O API without having started a
TSAM transaction.
Action

Contact the TmaxSoft technical support team.

TJES_ERR_TX_STARTED (-9004)
Description This error occurs when trying to start a TSAM transaction that has already started.
Action

Contact the TmaxSoft technical support team.

TJES_ERR_TX_NOT_COMMITED (-9005)
Description This error occurs when closing a transaction that has not been committed or
rolled back.
Action

Contact the TmaxSoft technical support team.

TJES_ERR_DS_NOT_ALLOC (-9012)
Description This error occurs when a dataset used in TJES has not been allocated.
Action

Check the TJES system dataset and catalog information.

TJES_ERR_EOF (-9029)
Description This error occurs when the end of a file is reached during sequential reading of
an internal file of TJES.

78 OpenFrame Error Message Reference Guide

Action

Contact the TmaxSoft technical support team.

TJES_ERR_FILE_NOT_FOUND (-9051)
Description This error occurs when an internal file used in TJES cannot be found.
Action

Check the status of the disk in which the spool exists and check access
permissions for the disk.

TJES_ERR_TRY_AGAIN (-9040)
Description This error occurs when there is a failure implementing the TJES two-phase
commit protocol logic. This error is not transmitted to external clients.
Action

Contact the TmaxSoft technical support team.

TJES_ERR_INVALID_JOBID (-9100)
Description This error occurs when a JOBID mismatches the given format. The format of a
JOBID is JOBnnnnn (where 0
Source Exif Data:
File Type : PDF
File Type Extension : pdf
MIME Type : application/pdf
PDF Version : 1.4
Linearized : No
Encryption : Standard V1.2 (40-bit)
User Access : Print, Copy, Annotate, Fill forms, Extract, Assemble, Print high-res
Title : OpenFrame
Creator : DocBook XSL Stylesheets V1.72.0
Author :
Producer : XEP 4.10 build 20070516
Trapped : False
Create Date : 2015:09:18 14:35:45
Modify Date : 2015:09:18 14:35:45
Page Count : 280
Page Mode : UseOutlines

EXIF Metadata provided by EXIF.tools

OpenFrame Open Frame V7.0 Error Message Reference Guide V2.1.1 En

Navigation menu

Versions of this User Manual:

Views

Navigation