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 |
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 IBM 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.