IFS Tools Commands
From Support
The IFS Tools software contains several commands for working with IFS files and Windows network files.
Listed below are the commands contained within the IFS tools product.
CHKOBJIFS - Check for IFS File Existence
Description: This command checks for an IFS file existence.
The command returns error CPF9898 if the IFS file is not found. The command returns error CPF9897 if the IFS file is found.
Parameters: IFS file name - Enter a valid IFS file.
IFSCOMPARE - IFS Binary File Comparison
Description: This command compares two files to insure they are exactly the same.
Parameters: IFS file name 1 - Enter a valid IFS file.
IFS file name 2 - Enter a valid IFS file.
IFSDIR - Retrieve IFS Directory Listing
Description: This command allows users to list the contents of an IFS folder to a regular physical file for use with RPG, etc.
Parameters: IFS Directory - Enter a valid IFS directory name to monitor.
Omit directory names - Default - *YES. This setting will leave out subdirectory entries when listing an IFS folder.
Omit processed files (*.sent) - Default - *NO. If enabled, this setting will leave out files that have been marked/renamed with a .sent extension.
File to receive output - Enter a file and library where the results should be written to. The file does not have to exist. It will get created.
IFSJAVAENV - Restore Java Objects for IFS Tools
Description: This is a one-time run command to restore the java objects needed by IFS Tools. RJS restores the java objects to the IFS.
Parameters: None
IFSMON - Monitor IFS Directory and Process Files
Description: This command allows users to monitor an existing IFS folder for events and then trigger an exit program to process the IFS file.
Parameters:
IFS Directory - Enter a valid IFS directory name to monitor.
Omit directory names - Default - *YES. This setting will leave out subdirectory entries when listing an IFS folder.
Omit processed files (*.sent) - Default - *YES. If enabled, this setting will leave out files that have been marked/renamed with a .sent extension.
File last accessed delay (min) - This setting determines how many minutes to wait since the last file access before processing the file.
File last modified delay (min) - This setting determines how many minutes to wait since the last file modification before processing the file.
File last attr change delay (min) - This setting determines how many minutes to wait since the last file attribute change before processing the file.
Exit program to process each file - Enter an exit program name to process the IFS file.
Delay processing or run once - Determine whether to run once or poll based on the delay between cycles - Default - *ONCE, *DELAY
Delay between cycles - Number of seconds between polling intervals. Default - 300 (5 minutes).
Time to end program (HHMMSS) - Time of day to end the monitor. Ex: Setting to 170000 will end the monitor at 5pm.
After processing option - This setting determines what happens to the IFS file after processing.
- NONE - Nothing
- MOVE - Move the file to another folder.
- MARK - Rename the IFS file with a .sent extension so it does not get processed again.
- DELETE - Delete the IFS file after is has been processed.
Move to IFS Directory name - Enter a valid IFS directory name to move the file to.
IFSSPOOL - Spool ASCII File from IFS
Description: This command takes any IFS file and spools the raw data into an output queue. Tha reasons for using this command can be many, but the main reason you might use it is that you want to print PC style reports through an iSeries printer by spooling the raw PCL or PDF to an output queue. The RJS iSeries report distribution and document management products can read documents from a spool file entry after the data has been spooled with IFSSPOOL.
Parameters: Input file - Enter a valid IFS input file name.
Destination output queue - Enter a valid output queue where the *USERASCII spool file will be created.
Spool File Name - Enter a spool file name for the document. Default - IFSDOC
User Data - Enter a spool file user data value. Default - IFSDOC
Form Type - Enter a form type value. Default - IFSDOC
User Defined Data - Enter a spool file user defined data value.
Hold spool file - Put spool file on hold.
Save spool file - Save spool file after it has been processed.
Copies - Number of copies for the new spool file.
Output priority - Enter the spool file output priority. RJS spool file processing applications look for priority 9 when processing *USERASCII spool files.
NBCPYLIST - Copy Netbios Dir List IFS File to Selected PF
Description: This command copies the resulting IFS file from the NBDIRLIST command to an AS/400 physical file as specified in the to file parameter.
Note: before using this command, make sure to run VFYJDK command once to verify that you have the 1.4 Java runtime on your iSeries. Also run the IFSJAVAENV command once to restore the needed java objects.
Parameters: From IFS file - IFS file where we will read the NBDIRLIST results from.
To file - Enter a file and library where the results should be written to. The file does not have to exist. It will get created.
NBDIRLIST - Get File List for Windows Netbios Share
Description: This command lists all files from the selected directory on a Windows server or Windows compatible server such as Linux running the Samba server. The results are returned into an IFS file which can be imported to a true physical file with the NBCPYLIST command.
Note: before using this command, make sure to run VFYJDK command once to verify that you have the 1.4 Java runtime on your iSeries. Also run the IFSJAVAENV command once to restore the needed java objects.
Parameters: Windows Domain: Enter a Windows Domain Name. Ex: If your Active Directory domain name is customerxyz.com, then your actial Windows Domain is probably: customxyz.
Windows Server/IP Name: Enter a DNS entry of IP address where server is located.
Windows Share Name: Enter a valid Windows share name. Ex: If the UNC path to your server was: \\SERVER1\SHARENAME1\SUBDIR then the share name should be entered in this parm as: SHARENAME1
Windows User: Enter a valid Windows user name for the selected Windows domain. Note: Windows user ID names ARE case sensitive.
Windows Password: Enter a valid Windows password for the selected Windows user. Note: Windows passwords ARE case sensitive.
Windows Directory on Share: Enter a valid Windows directory name within the Windows share. Ex: If the UNC path to your server was: \\SERVER1\SHARENAME1\SUBDIR then the directory name should be entered in this parm as: /SHARENAME1
Output IFS file: This is the IFS file that will receive the directory listing.
Display standard output result: Display java errors info. Default - *NO. This should be set to *YES when testing or debugging.
Delete standard output result: Delete java output file after. Default - *YES.
NBGETFILE - Get File from Windows Netbios Share
Description: This command retreives a file from a Windows share and writes it into an IFS file.
Note: before using this command, make sure to run VFYJDK command once to verify that you have the 1.4 Java runtime on your iSeries. Also run the IFSJAVAENV command once to restore the needed java objects.
Parameters: Windows Domain: Enter a Windows Domain Name. Ex: If your Active Directory domain name is customerxyz.com, then your actial Windows Domain is probably: customxyz.
Windows Server/IP Name: Enter a DNS entry of IP address where server is located.
Windows Share Name: Enter a valid Windows share name. Ex: If the UNC path to your server was: \\SERVER1\SHARENAME1\SUBDIR then the share name should be entered in this parm as: SHARENAME1
Windows User: Enter a valid Windows user name for the selected Windows domain. Note: Windows user ID names ARE case sensitive.
Windows Password: Enter a valid Windows password for the selected Windows user. Note: Windows passwords ARE case sensitive.
Windows File to Read: A valid Windows file name within the Windows share must be entered. Ex: If the UNC path to your file was: \\SERVER1\SHARENAME1\SUBDIR\WORDDOC.DOC then the file name should be entered in this parm as: /SHARENAME1/SUBDIR/WORDDOC.DOC
Output IFS file: This is the IFS file that will receive the file. Ex: /FILES/WORDDOC.DOC
Display standard output result: Display java errors info. Default - *NO. This should be set to *YES when testing or debugging.
Delete standard output result: Delete java output file after. Default - *YES.
NBPUTFILE - Put File to Windows Netbios Share
Description: This command sends a file from the IFS and writes it to a Windows share.
Note: before using this command, make sure to run VFYJDK command once to verify that you have the 1.4 Java runtime on your iSeries. Also run the IFSJAVAENV command once to restore the needed java objects.
Parameters: Windows Domain: Enter a Windows Domain Name. Ex: If your Active Directory domain name is customerxyz.com, then your actial Windows Domain is probably: customxyz.
Windows Server/IP Name: Enter a DNS entry of IP address where server is located.
Windows Share Name: Enter a valid Windows share name. Ex: If the UNC path to your server was: \\SERVER1\SHARENAME1\SUBDIR then the share name should be entered in this parm as: SHARENAME1
Windows User: Enter a valid Windows user name for the selected Windows domain. Note: Windows user ID names ARE case sensitive.
Windows Password: Enter a valid Windows password for the selected Windows user. Note: Windows passwords ARE case sensitive.
IFS file to read: This is the IFS file that will be sent to the Windows server. Ex: /FILES/WORDDOC.DOC
Output Windows File: A valid destination Windows file name within the Windows share must be entered. Ex: If the UNC path to your file was: \\SERVER1\SHARENAME1\SUBDIR\WORDDOC.DOC then the file name should be entered in this parm as: /SHARENAME1/SUBDIR/WORDDOC.DOC
Display standard output result: Display java errors info. Default - *NO. This should be set to *YES when testing or debugging.
Delete standard output result: Delete java output file after. Default - *YES.
PRDINFO - Retrieve OS/400 System Info
Description: This command retreives and displays system info for licensing.
PRDSEC - Enter OS/400 System Info
Description: This command is used to enter the RJS security access code.
RTVIFSSIZ - Retreive IFS File Size
Description: This command is used to retrieve the size of an IFS file.
Parameters: IFS file name - Enter a valid IFS file.
Return file size - Return the file size in bytes.
Return allocated size - Return the files allocated disk size in bytes. This value is usually different.
VFYJDK - Verify Java JDK
Description: This command is used to verify that the 1.4.x Java runtime is available on the selected system.
Parameters: None
Categories: IFS Tools | Knowledge Base | How To | TBPR
