CHKOUT (Check Out)

CHKOUT Command syntax diagram

 

Purpose

The Check Out (CHKOUT) command checks out an object. The object is named on the OBJ parameter. A user profile is used to determine who is checking out the object.

When an object is checked out, other users can read and copy the object. Only the user who has the object checked out can change the object until it is checked in (see the Check In (CHKIN) command).

For more information about integrated file system commands, see the Integrated file system topic in the File systems and management category of the Information Center.

 

Restrictions

1. Only documents within QDLS, and byte stream files can be checked out.
   
2. The user who submits this command must have *CHANGE authority to the object and at least execute (search) authority to the directory prefixes in the path.
   
3. Not all file systems will support the CHKOUT command.

 

Required Parameters

OBJ

Specifies the name of the object to check out or a pattern for multiple objects.

The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes.

See path names for more information on specifying path names.

Example for CHKOUT

CHKOUT   OBJ('MYDIR/FILE1')

This command checks out FILE1 in the directory, MYDIR, to the job's user profile owner.

Error messages for CHKOUT

*ESCAPE Messages

CPFA09C

Not authorized to object.

CPFA09D

Error occurred in program &1.

CPFA09E

Object in use.

CPFA0A1

An input or output error occurred.

CPFA0A3

Path name resolution causes looping.

CPFA0A7

Path name too long.

CPFA0A9

Object not found.

CPFA0AB

Object name not a directory.

CPFA0AD

Function not supported by file system.

CPFA0B2

No objects satisfy request.

CPFA0BE

&1 objects checked in. &2 objects failed.

CPFA0BF

&1 objects checked out. &2 objects failed.

CPFA0DA

Object name is a directory.

CPFA1C5

Object is a read only object.