AS/400 Toolbox for Java \ Tips for programming \ Integrated file system path names

Integrated file system path names for AS/400 objects

Your Java program must use integrated file system names to refer to AS/400 objects, such as programs, libraries, commands, or spooled files. The integrated file system name is the name of an AS/400 object as it would be accessed in the library file system of the integrated file system on the AS/400.

The path name may consist of the following pieces:

library The library in which the object resides. The library is a required portion of an integrated file system path name. The library name must be 10 or fewer characters and be followed by .lib.
object The name of the object that the integrated file system path name represents. The object is a required portion of an integrated file system path name. The object name must be 10 or fewer characters and be followed by .type, where type is the type of the object. Types can be found by prompting for the OBJTYPE parameter on commands, such as WRKOBJ.
type The type of the object. The type of the object must be specified when specifying the object. (See object above.) The type name must be 6 or fewer characters.
member The name of the member that this integrated file system path name represents. The member is an optional portion of an integrated file system path name. It can be specified only when the object type is FILE. The member name must be 10 or fewer characters and followed by .mbr.

Follow these conditions when determining and specifying the integrated file system name:

          /QSYS.LIB/object.type
          /QSYS.LIB/library.LIB/object.type

To see a list of these types, enter an AS/400 command that has object type as a parameter and press F4 (Prompt) for the type. For example, the AS/400 command Work with Objects (WRKOBJ) has an object type parameter.

Below are some commonly used types:

Abbreviation Object
.CMD command
.DTAQ data queue
.FILE file
.FNTRSC font resource
.FORMDF form definition
.LIB library
.MBR member
.OVL overlay
.PAGDFN page definition
.PAGSET page segment
.PGM program
.OUTQ output queue
.SPLF spooled file

Use these examples to determine how to specify integrated file system path names:

Description Integrated file system name
Program MY_PROG
in library MY_LIB
on the AS/400
/QSYS.LIB/MY_LIB.LIB/MY_PROG.PGM
Data queue MY_QUEUE
in library MY_LIB
on the AS/400
/QSYS.LIB/MY_LIB.LIB/MY_QUEUE.DTAQ
Member JULY
in file MONTH
in library YEAR1998
on the AS/400
/QSYS.LIB/YEAR1998.LIB/MONTH.FILE/JULY.MBR

Special values that the AS/400 Toolbox for Java recognizes in the integrated file system

In an integrated file system path name, special values that normally begin with an asterisk, such as *ALL, are depicted without the asterisk. Instead, use leading and trailing percent signs (%ALL%). In the integrated file system, an asterisk is a wildcard character.

The AS/400 Toolbox for Java classes recognize the following special values:

With Use (Instead Of)
Library name %ALL% (*ALL)
%ALLUSR% (*ALLUSR)
%CURLIB% (*CURLIB)
%LIBL% (*LIBL)
%USRLIBL% (*USRLIBL)
Object name %ALL% (*ALL)
Member name %ALL% (*ALL)
%FILE% (*FILE)
%FIRST% (*FIRST)
%LAST% (*LAST)

See the QSYSObjectPathName class for information about building and parsing integrated file system names.


[ Information Center Home Page | Feedback ] [ Legal | AS/400 Glossary ]