7.3.3 Format and definition of measurement conditions (service-specific condition sections)

This subsection describes the format and definition of measurement conditions for each target Internet service.

The 12 types of SERVICE_IDs are described below.

Organization of this subsection
(1) HTTP
(2) HTTPS
(3) SMTP
(4) POP3
(5) IMAP4
(6) DNS
(7) DHCP
(8) FTP
(9) TCP
(10) WEBTRANS
(11) IESCENA
(12) USERSERV

(1) HTTP

This subsection describes the tags for the settings specific to the HTTP service.

(a) Format

<SERV_PARAM>
  <HTTP>
    <URL>URL</URL>
    <POST>
      <MESSAGE_BODY>message-body</MESSAGE_BODY>
    </POST>
    <DEPTH>depth</DEPTH>
    <WEB_AUTH>
      <WEB_USERNAME>Web-authentication-user-name</WEB_USERNAME>
    </WEB_AUTH>
    <PROXY>
      <PROXY_HOSTNAME>proxy-host-name-or-IP-address</PROXY_HOSTNAME>
      <PROXY_PORT>proxy-port-number</PROXY_PORT>
      <PROXY_USERNAME>proxy-user-name</PROXY_USERNAME>
    </PROXY>
  </HTTP>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (HTTP)

Table 7-11 Definition of <SERV_PARAM> (HTTP)

XML tagMandatoryRole of tag and value to be specified
<HTTP>...</HTTP>YContains the parameters specific to the HTTP service.
<URL>...</URL>
((character string of up to 255 bytes))#5
YSpecifies the URL of the Web page to be subject to measurement. The protocol identifier (http://) is not included. The port number can be omitted. If the port number is omitted, port number 80 is used.
<POST>...</POST>--Specifies that the POST method is to be measured. To set this tag, use the <MESSAGE_BODY> tag. To omit the specification, omit the <POST> tag and the tags contained in the <POST> tag. When this tag is omitted, the GET method is used.
<MESSAGE_BODY>...</MESSAGE_BODY>
((1 to 1,023 bytes of character string))
--#1Specifies a character string that is to be sent as the message body for transmission by the POST method. When the POST method is used, this item cannot be omitted.
<DEPTH>...</DEPTH>
((1 to 100))<<2>>
--Specifies the depth of embedded resources and frames to be acquired. This is the depth of the resources and frames in the Web page that are to be downloaded. The following shows examples:
DEPTH=1 is specified:
Only the Web page is downloaded.
DEPTH=2 is specified:
The Web page and the resources and frames embedded in the page are downloaded.
3 or a greater value is specified in DEPTH:
The Web page, the resources and frames embedded in the page, and the information embedded in the acquired frames (such as the resources and frames embedded in the downloaded frames) are downloaded up to the specified depth. If nothing is embedded in an acquired frame, no more acquisition is performed.
For details about embedded resources and frames, see HTTP in 9. Records.
<WEB_AUTH>...</WEB_AUTH>--Specifies that Web authentication is to be performed. Use the <WEB_USERNAME> tag to specify the settings related to Web authentication. To omit the specification, omit the <WEB_AUTH> tag and all the tags contained in it.
<WEB_USERNAME>...</WEB_USERNAME>
((character string of up to 64 bytes))
--#2Specifies the user name to be used for Web authentication. This tag is applicable only when Web authentication is executed.
<PROXY>...</PROXY>--Specifies that a proxy is to be used. Use the <PROXY_HOSTNAME>, <PROXY_PORT>, and <PROXY_USERNAME> tags to specify the proxy-related settings. To omit the specification, omit the <PROXY> tag and all the tags contained in it.
<PROXY_HOSTNAME>...</PROXY_HOSTNAME>
((character of up to 255 bytes))#6
--#3Specifies the proxy server's host name or IP address. This tag is applicable only when a proxy is used.
<PROXY_PORT>...</PROXY_PORT>
((1 to 65535))
--#3Specifies the proxy server's port number. This tag is applicable only when a proxy is used.
<PROXY_USERNAME>...</PROXY_USERNAME>
((character of up to 64 bytes))
--#4Specifies the user name to be used for proxy authentication. If proxy authentication is not performed, omit this tag.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value
#1
This item is mandatory when the <POST> tag is specified.
#2
This item is mandatory when the <WEB_AUTH> tag is specified.
#3
This item is mandatory when the <PROXY> tag is specified.
#4
This item is mandatory when the <PROXY> tag is specified and proxy authentication is performed.
#5
To use an IP address to specify a host name, use an IPv4 dotted-decimal address (for example: 172.16.233.12/example.html) or an IPv6 hexadecimal address enclosed in square brackets, using colons as separators (for example: [ACE6:45:75:91::1]/example.html).
#6
To specify an IPv4 address for the host name, use dotted-decimal format (for example: 172.16.233.12). To specify an IPv6 address, use hexadecimal format, using colons as separators (for example: ACE6:45:75:91::1).

(2) HTTPS

This subsection describes the tags for the settings specific to the HTTPS service.

(a) Format

<SERV_PARAM>
  <HTTPS>
    <URL>URL</URL>
    <POST>
      <MESSAGE_BODY>message-body</MESSAGE_BODY>
    </POST>
    <DEPTH>depth</DEPTH>
    <WEB_AUTH>
      <WEB_USERNAME>Web-authentication-user-name</WEB_USERNAME>
    </WEB_AUTH>
    <PROXY>
      <PROXY_HOSTNAME>proxy-host-name-or-IP-address</PROXY_HOSTNAME>
      <PROXY_PORT>proxy-port-number</PROXY_PORT>
      <PROXY_USERNAME>proxy-user-name</PROXY_USERNAME>
    </PROXY>
    <SSL_AUTH_IGNORE></SSL_AUTH_IGNORE>
    <CLIENT_AUTH>
      <CLIENT_CERT_FILE>client-certificate-file-name</CLIENT_CERT_FILE>
    </CLIENT_AUTH>
  </HTTPS>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (HTTPS)

Table 7-12 Definition of <SERV_PARAM> (HTTPS)

XML tagMandatoryRole of tag and value to be specified
<HTTPS>...</HTTPS>YContains the parameters specific to the HTTPS service.
<URL>...</URL>
((character string of up to 255 bytes))
YSpecifies the URL of the Web page to be subject to measurement. The protocol identifier (https://) is not included. The port number can be omitted. If the port number is omitted, port number 443 is used.
<POST>...</POST>--Specifies that the POST method is to be measured. To set this tag, use the <MESSAGE_BODY> tag. To omit the specification, omit the <POST> tag and the tags contained in the <POST> tag. When this tag is omitted, the GET method is used.
<MESSAGE_BODY>...</MESSAGE_BODY>
((1 to 1,023 bytes of character string))
--#1Specifies a character string that is to be sent as the message body for transmission by the POST method.
<DEPTH>...</DEPTH>
((1 to 100))<<2>>
--Specifies the depth of embedded resources and frames to be acquired. This is the depth of the resources and frames in the monitored Web page that are to be downloaded. The following shows examples:
DEPTH=1 is specified:
Only the Web page is downloaded.
DEPTH=2 is specified:
The Web page and the resources and frames embedded in the page are downloaded.
3 or a greater value is specified in DEPTH:
The Web page, the resources and frames embedded in the page, and the information embedded in the acquired frames (such as the resources and frames embedded in the downloaded frames) are downloaded up to the specified depth. If nothing is embedded in an acquired frame, no more acquisition is performed.
For details about embedded resources and frames, see HTTPS in 9. Records.
<WEB_AUTH>...</WEB_AUTH>--Specifies the settings related to Web authentication. Specify this tag to perform Web authentication. If you do not want to perform Web authentication, omit the <WEB_AUTH> tag and all the tags contained in it.
<WEB_USERNAME>...</WEB_USERNAME>
((character string of up to 64 bytes))
--#2Specifies the user name to be used for Web authentication. This tag is applicable only when Web authentication is executed.
<PROXY>...</PROXY>--Specifies that a proxy is to be used. Use the <PROXY_HOSTNAME>, <PROXY_PORT>, and <PROXY_USERNAME> tags to specify the proxy-related settings. To omit the specification, omit the <PROXY> tag and all the tags contained in it.
<PROXY_HOSTNAME>...</PROXY_HOSTNAME>
((character of up to 255 bytes))
--#3Specifies the proxy server's host name or IP address. This tag is applicable only when a proxy is used.
<PROXY_PORT>...</PROXY_PORT>
((1 to 65535))
--#3Specifies the proxy server's port number. This tag is applicable only when a proxy is used.
<PROXY_USERNAME>...</PROXY_USERNAME>
((character of up to 64 bytes))
--#4Specifies the user name to be used for proxy authentication. If proxy authentication is not performed, omit this tag.
<SSL_AUTH_IGNORE>
</SSL_AUTH_IGNORE>
--Specifies that measurement is to continue when SSL server authentication fails. To terminate measurement if SSL server authentication fails, omit this tag.
<CLIENT_AUTH>...</CLIENT_AUTH>--Specifies that client authentication is to be performed. Use the <CLIENT_CERT_FILE> tag to specify the settings related to client authentication. If you do not want to perform client authentication, omit the <CLIENT_AUTH> tag and all the tags contained in it.
<CLIENT_CERT_FILE>...</CLIENT_CERT_FILE>
((character of up to 255 bytes))
--#5Specifies the file in which the client certificate and private key are stored. Use a maximum of 255 bytes to specify the name of a file that is stored in installation-folder\agtv\probe\cert. Do not include the path. The file must be converted to Base64-encoded X.506 format.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value
#1
This item is mandatory when the <POST> tag is specified.
#2
This item is mandatory when the <WEB_AUTH> tag is specified.
#3
This item is mandatory when the <PROXY> tag is specified.
#4
This item is mandatory when the <PROXY> tag is specified and proxy authentication is performed.
#5
This item is mandatory when the <CLIENT_AUTH> tag is specified.

(3) SMTP

This subsection describes the tags for the settings specific to the SMTP service.

(a) Format

<SERV_PARAM>
  <SMTP>
    <HOSTNAME>host-name-or-IP-address</HOSTNAME>
    <PORT>port-number</PORT>
    <MSG_SIZE>message-size</MSG_SIZE>
    <DST_MAIL_ADDR>destination-email-address</DST_MAIL_ADDR>
    <SRC_MAIL_ADDR>source-email-address</SRC_MAIL_ADDR>
    <POP3_AUTH>
      <POP3_HOSTNAME>POP3-host-name-or-IP-address</POP3_HOSTNAME>
      <POP3_PORT>POP3-port-number</POP3_PORT>
      <POP3_USERNAME>POP3-user-name</POP3_USERNAME>
    </POP3_AUTH>
  </SMTP>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (SMTP)

Table 7-13 Definition of <SERV_PARAM> (SMTP)

XML tagMandatoryRole of tag and value to be specified
<SMTP>...</SMTP>YContains the parameters specific to the SMTP service.
<HOSTNAME>...</HOSTNAME>
((character string of up to 255 bytes))
YSpecifies the SMTP server's host name or IP address.
<PORT>...</PORT>
((1 to 65535))<<25>>
--Specifies the SMTP server's port number.
<MSG_SIZE>...</MSG_SIZE>
((0 to 10000))(bytes)
YSpecifies the size of the text for a measurement email.
<DST_MAIL_ADDR>...</DST_MAIL_ADDR>
((character string of up to 256 bytes))
YSpecifies exactly one email address to which a measurement email is to be sent.
<SRC_MAIL_ADDR>...</SRC_MAIL_ADDR>
((character string of up to 256 bytes))
--Specifies the email address from which a measurement email is to be sent.
<POP3_AUTH>...</POP3_AUTH>--Specifies that POP3 (POP before SMTP) authentication is to be performed. Use the <POP3_HOSTNAME>, <POP3_PORT>, and <POP3_USERNAME> tags to specify the settings related to POP3 authentication. To omit the specification, omit the <POP3_AUTH> tag and all the tags contained in it.
<POP3_HOSTNAME>...</POP3_HOSTNAME>
((character string of up to 255 bytes))
--#Specifies the POP3 server's host name or IP address. This tag is applicable only when POP3 authentication is executed.
<POP3_PORT>...</POP3_PORT>
((1 to 65535))<<110>>
--#Specifies the POP3 server's port number. This tag is applicable only when POP3 authentication is executed.
<POP3_USERNAME>...</POP3_USERNAME>
((character string of up to 40 bytes))
--#Specifies the user name to be used for POP3 authentication. This tag is applicable only when POP3 authentication is executed.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value
#
This item is mandatory when the <POP3_AUTH> tag is specified.

(4) POP3

This subsection describes the tags for the settings specific to the POP3 service.

(a) Format

<SERV_PARAM>
  <POP3>
    <HOSTNAME>host-name-or-IP-address</HOSTNAME>
    <PORT>port-number</PORT>
    <USERNAME>user-name</USERNAME>
    <NON_DELETE_MAIL></NON_DELETE_MAIL>
  </POP3>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (POP3)

Table 7-14 Definition of <SERV_PARAM> (POP3)

XML tagMandatoryRole of tag and value to be specified
<POP3>...</POP3>YContains the parameters specific to the POP3 service.
<HOSTNAME>...</HOSTNAME>
((character string of up to 255 bytes))
YSpecifies the POP3 server's host name or IP address.
<PORT>...</PORT>
((1 to 65535))<<110>>
--Specifies the POP3 server's port number.
<USERNAME>...</USERNAME>
((character string of up to 40 bytes))
YSpecifies the user name to be used in the POP3 service.
<NON_DELETE_MAIL>
</NON_DELETE_MAIL>
--Specifies that read emails are not to be deleted. To delete read emails, omit this tag.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value

(5) IMAP4

This subsection describes the tags for the settings specific to the IMAP4 service.

(a) Format

<SERV_PARAM>
  <IMAP4>
    <HOSTNAME>host-name-or-IP-address</HOSTNAME>
    <PORT>port-number</PORT>
    <USERNAME>user-name</USERNAME>
    <DELETE_MAIL></DELETE_MAIL>
  </IMAP4>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (IMAP4)

Table 7-15 Definition of <SERV_PARAM> (IMAP4)

XML tagMandatoryRole of tag and value to be specified
<IMAP4>...</IMAP4>YContains the parameters specific to the IMAP4 service.
<HOSTNAME>...</HOSTNAME>
((character string of up to 255 bytes))
YSpecifies the IMAP4 server's host name or IP address.
<PORT>...</PORT>
((1 to 65535))<<143>>
--Specifies the IMAP4 server's port number.
<USERNAME>...</USERNAME>
((character string of up to 64 bytes))
YSpecifies the user name to be used in the IMAP4 service.
<DELETE_MAIL>
</DELETE_MAIL>
--Specifies that read emails are to be deleted. If you do not want to delete read emails, omit this tag.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value

(6) DNS

This subsection describes the tags for the settings specific to the DNS service.

(a) Format

<SERV_PARAM>
  <DNS>
    <IPADDRESS>IP-address</IPADDRESS>
    <PORT>port-number</PORT>
    <QUERY>name-of-host-to-be-searched</QUERY>
    <RETRY>retries-count</RETRY>
  </DNS>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (DNS)

Table 7-16 Definition of <SERV_PARAM> (DNS)

XML tagMandatoryRole of tag and value to be specified
<DNS>...</DNS>YContains the parameters specific to the DNS service.
<IPADDRESS>...</IPADDRESS>YSpecifies the DNS server's IP address. Only the IP address is accepted; the DNS name is not accepted.
<PORT>...</PORT>
((1 to 65535))<<53>>
--Specifies the DNS server's port number.
<QUERY>...</QUERY>
((character string of up to 255 bytes))
YSpecifies the name of the host to be searched.
<RETRY>...</RETRY>
((1 to 5))<<1>>
--Specifies the number of retries. From this value and the timeout value specified in the <TIME_OUT> tag contained in the <GEN_PARAM> tag, the retry timeout value is determined and set automatically. The formula is as follows:
Retry timeout value = timeout value/(number of retries + 1)
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value

(7) DHCP

This subsection describes the tags for the settings specific to the DHCP server.

(a) Format

<SERV_PARAM>
  <DHCP>
    <HOSTNAME>host-name-or-IP-address</HOSTNAME>
    <PORT>port-number</PORT>
    <PROBE_PORT>probe's-port-number</PROBE_PORT>
    <NON_ACCEPT_OFFER></NON_ACCEPT_OFFER>
  </DHCP>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (DHCP)

Table 7-17 Definition of <SERV_PARAM> (DHCP)

XML tagMandatoryRole of tag and value to be specified
<DHCP>...</DHCP>YContains the parameters specific to the DHCP service.
<HOSTNAME>...</HOSTNAME>
((character string of up to 255 bytes))
YSpecifies the DHCP server's host name or IP address.
<PORT>...</PORT>
((1 to 65535))<<67>>
--Specifies the DHCP server's port number.
<PROBE_PORT>...</PROBE_PORT>
((1 to 65535))<<68>>
--Specifies the port number of the probe that is used as the DHCP client in measuring the measurement condition.
<NON_ACCEPT_OFFER>
</NON_ACCEPT_OFFER>
--Specifies that the IP address assigned from the DNS server is not to be accepted. To accept it, omit this tag.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value

(8) FTP

This subsection describes the tags for the settings specific to the FTP service.

(a) Format

<SERV_PARAM>
  <FTP>
    <HOSTNAME>host-name-or-IP-address</HOSTNAME>
    <PORT>port-number</PORT>
    <USERNAME>user-name</USERNAME>
    <TRANS_DIRECTION>transfer-direction</TRANS_DIRECTION>
    <FILE_NAME>name-of-transferred-file</FILE_NAME>
    <PASSIVE></PASSIVE>
  </FTP>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (FTP)

Table 7-18 Definition of <SERV_PARAM> (FTP)

XML tagMandatoryRole of tag and value to be specified
<FTP>...</FTP>YContains the parameters specific to the FTP service.
<HOSTNAME>...</HOSTNAME>
((character string of up to 255 bytes))
YSpecifies the FTP server's host name or IP address.
<PORT>...</PORT>
((1 to 65535))<<21>>
--Specifies the FTP server's port number.
<USERNAME>...</USERNAME>
((character string of up to 64 bytes))
YSpecifies the user name to be used in the FTP service.
<TRANS_DIRECTION>...</TRANS_DIRECTION>
((UPLOAD or DOWNLOAD))
YSpecifies the file transfer method.#1 To transfer a file to the server, specify UPLOAD; to transfer a file from the server, specify DOWNLOAD.
<FILE_NAME>...</FILE_NAME>
((character string of up to 32 bytes))
YSpecifies the name of the file to be transferred.
<PASSIVE></PASSIVE>--Specifies the connection mode.#2 This tag is used to establish data connection in the PASSIVE mode. To omit the specification, omit this tag. When this tag is omitted, data transfer connection is established in the ACTIVE mode.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the tag.
<< >>: Default value
#1
A transfer file for measurement must already be stored in the following folder:
For UPLOAD: installation-folder\agtv\probe\probedata\ftp
For DOWNLOAD: Specified account's home directory
#2
The connection establishment method depends on the connection mode, as described below:
In the ACTIVE mode:
The connection request for file transfer is issued from the FTP server.
In the PASSIVE mode:
The connection request for file transfer is issued from the FTP probe.

(9) TCP

This subsection describes the tags for the settings specific to the TCP service.

(a) Format

<SERV_PARAM>
  <TCP>
    <HOSTNAME>host-name-or-IP-address</HOSTNAME>
    <PORT>port-number</PORT>
  </TCP>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (TCP)

Table 7-19 Definition of <SERV_PARAM> (TCP)

XML tagMandatoryRole of tag and value to be specified
<TCP>...</TCP>YContains the parameters specific to the TCP service.
<HOSTNAME>...</HOSTNAME>
((character string of up to 255 bytes))#
YSpecifies the TCP server's host name or IP address.
<PORT>...</PORT>
((1 to 65535))
YSpecifies the TCP server's port number.
Legend:
Y: Mandatory item
(( )): Specifiable value range of the tag.
#
To specify an IPv4 address for the host name, use dotted-decimal format (for example: 172.16.233.12). To specify an IPv6 address, use hexadecimal format, using colons as separators (for example: ACE6:45:75:91::1).

(10) WEBTRANS

This subsection describes the tags for the settings specific to the WEBTRANS service.

(a) Format

<SERV_PARAM>
  <WEBTRANS>
    <TRANSACTION_FILE>Web-transaction-file-name</TRANSACTION_FILE>
    <TRANSACTION_NAME>Web-transaction-name</TRANSACTION_NAME>
  </WEBTRANS>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (WEBTRANS)

Table 7-20 Definition of <SERV_PARAM> (WEBTRANS)

XML tagMandatoryRole of tag and value to be specified
<WEBTRANS>...</WEBTRANS>YContains the parameters specific to the WEBTRANS service.
<TRANSACTION_FILE>...</TRANSACTION_FILE>
((character string of up to 255 bytes))
YSpecifies the name of the Web transaction file.
Specify a file with the extension .xml that is stored in installation-folder\agtv\probe\webtrans.
  • Do not include the path.
  • The specified name is not case sensitive.
<TRANSACTION_NAME>...</TRANSACTION_NAME>
((character string of up to 255 bytes))
YSpecifies the name of the Web transaction. The vertical bar character (|) cannot be used.
Legend:
Y: Mandatory item
(( )): Specifiable value range of the tag.

(11) IESCENA

This subsection describes the tags for the settings specific to the IE scenario.

(a) Format

<SERV_PARAM>
  <IESCENA>
    <IESCENA_FILE>IE-scenario-file-name</IESCENA_FILE>
  </IESCENA>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (IESCENA)

Table 7-21 Definition of <SERV_PARAM> (IESCENA)

XML tagMandatoryRole of tag and value to be specified
<IESCENA>...</IESCENA>YThe tag to contain the parameters specific to the IE scenario.
<IESCENA FILE>...
</ IESCENA FILE>
((character string of up to 255 bytes)
YSpecifies the name of the IE scenario file. Specify a file with the extension .xml that is stored in
installation-folder\agtv\probe\iescena.
  • Do not include the path.
  • The specified name is not case sensitive.
Legend:
Y: Mandatory item
(( )): Specifiable value range of the tag.

(12) USERSERV

This subsection describes the tags for the settings specific to a user-defined service.

(a) Format

<SERV_PARAM>
  <USERSERV>
    <USER_SERVICE_ID>user-defined-service-ID</USER_SERVICE_ID>
  </USERSERV>
</SERV_PARAM>

(b) Definition of <SERV_PARAM> (USERSERV)

Table 7-22 Definition of <SERV_PARAM> (USERSERV)

XML tagMandatoryRole of tag and value to be specified
<USERSERV>...</USERSERV>YContains the parameters specific to a user-defined service.
<USER_SERVICE_ID>...</USER_SERVICE_ID>
((1 to 100))
YSpecifies a user-defined service ID that has been registered in the command registration file.
Legend:
Y: Mandatory item
(( )): Specifiable value range of the tag.