The client configuration request (CCR) notifies the Client Configuration Manager that a particular Windows NT-based client needs to be configured. The CCR file is a small text file with an INI file format. The file is named SMSID.CCR, where SMSID is the 8 character SMS ID assigned to the client.
New CCR files are created by SMS Client Setup for Windows NT (CLI_NT). CCR files are placed in the LOGON.SRV\CCR.BOX directory. CCR files that have failed at least one processing attempt by Client Configuration Manager are moved to the LOGON.SRV\CCR.BOX\RETRY directory.
The CCR file has two sections:
Dates and times in the [NT Client Configuration Request] section are relative to the client. The [NT Client Configuration Request] section has the following keys:
Machine Name
The name of the target client. It is used by Client Configuration Manager to locate the computer.
Domain
The name of the SMS domain that the client belongs to, as determined by CLI_NT. Client Configuration Manager uses this field to establish remote administrative access to the system.
Initial Request Date
The date and time when CLI_NT created a new CCR.
Latest Request Date
The date and time that CLI_NT last updated the CCR.
Client Request Count
The number of times that CLI_NT requested configuration work since this CCR was created.
Dates and times in the [Request Processing] section are relative to the server running Client Configuration Manager. The [Request Processing] section has the following keys:
Initial Processing Attempt
The date and time when Client Configuration Manager first attempted to process the request. It is used to determine when to report a delayed error event to the SMS database.
Retry Interval Start
The date and time when Client Configuration Manager first attempted to process the request after a new CCR was received for this computer. It is used to determine when to stop retrying this request and report an event to the SMS database.
Latest Processing Attempt
The date and time when Client Configuration Manager last attempted to process the request.
Number of Processing Attempts
A count incremented each time Client Configuration Manager unsuccessfully attempts to process the request.
Last Error Code
A numeric code indicating the error that prevented Client Configuration Manager from processing the request on the latest attempt.
The keys Machine Name, Domain, Initial Request Date, Latest Request Date, and Client Request Count are written by CLI_NT when the request is created.
The keys Latest Request Date, Client Request Count, and Retry Interval Start are updated by Client Configuration Manager when it finds that a CCR already exists for the specified SMS ID.
The keys Initial Processing Attempt, Latest Processing Attempt, Number of Processing Attempts, and Last Error Code are updated each time Client Configuration Manager encounters an error while attempting to process the CCR.
A sample CCR file follows:
[NT Client Configuration Request] Machine Name=MACHINE01 Domain=SMS_DOMAIN Initial Request Date=01/01/1996 23:00 Latest Request Date=01/01/1996 23:00 Client Request Count=1 [Request Processing] Initial Processing Attempt=01/01/1996 23:14 Retry Interval Start=01/01/1996 23:14 Latest Processing Attempt=01/04/1996 3:44 Number of Processing Attempts=8 Last Error Code=5