## MMPM/2 Device Driver Reference

[prev][next][parent][TOC]

### Starting P2STRING

The P2STRING tool consists of two files: P2STRING.EXE and P2S_DLL.DLL. These files are located in the IBM Developer Connection Device Driver Kit for OS/2. The following example displays the syntax used to start the P2STRING program. Associated parameters are described in the following table.

    P2STRING inp_file [-a]out_file [-eerr_file] [-d|-D] [-E] [-t]

Note: The parameters are case sensitive.

The following list describes the parameters associated with the P2STRING program.

Parameter Description

script_file Specifies the script file name you want to process.

Note: Refer to P2STRING Script Language for information on the contents of a script file and how to interpret the script language.

[-a]out_file Specifies the output file name containing the results of the test. This file contains only the results of the test you are running, unless you specify the optional -a parameter. For example, to append the output of a script file named SAMPLE.SCR to output currently in a file named MDM.OUT, type:

    P2STRING SAMPLE.SCR -aMDM.OUT

[-eerr_file] Specifies the optional error file name that receives messages from string commands that completed unsuccessfully. For example, to create an error file named MDM.ERR, type:

    P2STRING SAMPLE.SCR MDM.OUT -eMDM.ERR

[-d|-D] Specifies one of the following optional parameters:

    -d     Instructs P2STRING to end after processing a script file.
           Use this parameter when you are running test cases automatically  .
           There is no change in the output.
           When the script file has completed processing, P2STRING prompts
           you with a message requiring you to end the test.
    -D     Behaves identically to the -d parameter except that the script
           directives requiring user input are ignored.

Note: Refer to Tool Directives for information on how to add execution directives (which require user input) in a script file.

-E Causes the script file to exit after the first error. By default, script files run to completion regardless of errors. For example, the following command ends the processing of SAMPLE.SCR after an error is encountered:

    P2STRING SAMPLE.SCR -aMDM.OUT -d -eMDM.ERR -E

-t Records time stamps for strings and MM_MCIPASSDEVICE notification messages.